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TheBeginning 


This book is designed as an introduction to the field of machine 
and assembly language programming for the "Sinclair ZX Spectrum. 


It may be that you are coming to this book with mo cl 
what machine language programming is all about. 


= idea of 


You may not even know what machine language is. You may not even be 
aware that there їз a difference between machine language and 
assembly language, nor indeed how they differ from programming in 
BASIC. 


Don't worry, and don't be frightened by the jargon - we will 
explain everything step by step. 


First, let us look at the way a computer operate 


Programmer — — — Keyboard 


ТУ Screen e — — — operat ing System 


Central 
Processing 
Unit 


y= aims to show {а that there is a barrier between 
the programmer and the brain of the Spectrum, the Central 
Processing Unit. 16 is mot possible under normal processing for 
the programmer to tell the Central Processing Unit - usually 
referred to as the CPU - what to do. 


ion of the popular 280 chip. There are 4 chij 
6502, 6809, and 8088 - which have become widely accepted 
for microcomputers. The 280 is by far the most popular chip. 


1 am sure ít comes ав по surprise to learn that the 2804 does not 
understand a word of 'BASIC'! Indeed по CPU has been designed so 
that we can communicate directly with the brain of the computer. 


1f you think about it for long enough, you will realise that it 
would be very difficult, if mot impossible, in any case to give а 
chip in a computer an instruction that would make any sense to a 
human. Take the top off your Sinclair (if you dare!) and have a 
look at the chip nearest to the speaker - this is the 2804 CPU. 
Obviously this chip in your computer can only respond to electrical 
Signals that are passed on to it by the rest of the circuitry! 


What is Machine Language? 


The 280 chip has been designed in such a way that it cam accept 
signals simultaneously from eight of the pins connected to it. 


The designers of the 280 chip constructed it in such a vay that 
different combinations of signals to the 280 chip along these eight 
pins would ‘instruct the 280 to perform different functions. 


Keeping in mind that what is really happening are electrical 
signals, let's adopt a convention to represent these signals - for 
example shoving а 1. Lf there is а signal to one of the pins, or а 
ОЩЕ there is no signal. 


A typical instruction might therefore look something like: 
0011 1100 


Quite a long vay from something like 
"etr Aa 1. 
for example, isn't it! 


Nonetheless, 
says it all 


this is what machine Language is all about. The тате 
It is а language for machines. Each manufacturer of 
mt ‘Language’ for its 


the different chips has designed a diffe 
products! 


someone else's work which allows me to program the computer in a 
сово? 


+ FASTER EXECUTION ОР THE PROGRAM 
= MORE EFFICIENT USE OF MEMORY 
SHORTER PROGRAMS (in memory) 
+ FREEDOM FROM THE OPERATING SYSTEM 


Ali of the above benefits are a direct result of programming in a 
language that the CPU can understand without having to have it 
translated first. When you program іп BASIC, the operating system 
is the machine language program that is really being run by the 
machine. The program is something like: 


Next Look at next instruction 
Translate it into а series of 
machine language instructions 
Perform each instruction 
Store the result if required 
Go to Next again 


If you are wondering where the computer finds this program, the 

operating system, it is in the ROM. In other words, it is built 

into the Spectrum. (ROM is the abbreviation for Read Only Memory, 
fons whose content you cannot change, but can only be 


Programming in BASIC can be up to 60 times slower than а program 
written directly іп machine Language! 


This is because translation takes time, and also the resulting 
machine language instructions generated usually are less efficient. 
Similarly, it is usually faster to drive yourself than to take 
public transport; you cam take shortcuts you know, instead of 
following the public transport route which needs to cater for the 
GENERAL public CASE. 


Nonetheless, ме would have to be anong the First to admit that 
programming in machine language does have drawbacks. 


The main dis; 


ivantage of machine Language are: 
+ PROGRAMS ARE DIFFICULT TO READ AND DEBUG 
+ IMPOSSIBLE TO ADAPT TO OTHER COMPUTERS 
+ LONGER PROGRAMS (in instructions) 
+ ARITHMETIC CALCULATIONS DIFFICULT 


This means that you must make а very conscious decision of which 
Programming method you should use for each particular application. 


A very long program for financial applications should be written in 
а language designed со deal with numbers and one in which progr 
can be easily modified if required. 


On the other hand there is nothing quite so bad 
written in BASIC - when you get down to it, it is Just too slow. 


Your own needs, the amount of memory in your computer, the response 
time required, the time available for development, and so on will 
determine your choice of programming Langua 


Thus, in summary, machine language is a series of commands which 
the CPU сап understand and which can be represented by numbers. 


What is Assembly Language? 


Quite obviously if machine language could only be represented by 
numbers, very few people would be able to write programs in machine 
Language 


After all, who could make sense of a program which looked like 
90109901 
0000000 
91000000 


Fortunately, we can invent a series of names for each of these 
numbers. Assembly Language is just such a representation of Machine 
Language so that it сап be read by humans in а form that is easter 
to underst 

өтті 


There is only one difference between As: 
Language: Assembly Language is one level higher than Machine 

Langua 11у read by humans than Machine Language, 
but on the other hand, computers can't read Assembly Langu: 


bly Language and Machine 


1t is mot am adaptation of Machine Language such as BASIC. For 
each Assembly Language instruction there is an identical (in 
function) Machine Language instruction, and vise versa. le. there 
is а ONE-TO-ONE relationship between them. We can therefore say 
that Assembly Language is EQUIVALENT to Machine Language. 


Assembly Language makes use of mnemomics (or 

enhance readability. For example at this sta 
le не. 

may mot sean much to you, but at least you can read it. 1f you 

were told that "INC' is а standard abbreviation (or mnemonic) fe 

INCrease and that HL is a ‘variable’, then by simply looking at 

that instruction you can get a feel for what is happening. 


reviations) to 
the instruction 


The same instruction їп Machine Language is 

0010 0011 
Now obviously you can also "read" that instruction in the sense 
that you сап read the number, but it isn't going to mean much to 
you unless you have a table to look up or when your brain is 
functioning almost like a computer. 


Assembly Language сап be converted directly to machine code by a 
program or by you. Such a program is called'an ASSEMBLER. You сап 
See this as а program which performs the rather boring task of 
translating your assembly language program into a sequence of 
machine language instructions that the Spectrum will understand. 
And we understand that an ASSEMBLER for the 2X Spectrum is already 
available. 


Nonetheless, such assenblers typically require 6K of memory, and 
are therefore of limited use оп a 16K machine, The Spectrum display 
takes up 7K of memory, and after loading the Assembler you may have 
only АК of memory left for your assembly language program. (This 
Vill means about 1/2 K of machine language program). 


The alternative to an Assembler program is for you to do the 
translation of the assembly language mnemonics into machine 
language by hand, using the tables provided in this book. 


It's hard, it's frustrating at first, it's inconvenient, but it 


wonderful practice and gives you a great insight into the vay the 
Spectrum CPU works. 


We would in fact recommend that you try writing short machine 
language programs in this way - (е writing them in assembly 


language and translating it into machine language by hand - before 
buying an Assembler program. 


cru 
The central processing unit of the computer. This is the chip 


that does the controlling and calculating work in the compute 


Machine Language 

The language understood by the CPU. For the Spectrum's CPU, 
this is the 280 machine language which 15 made up of about 200 
"instruct tons? 


BASIC languag 

А computer language designed to be intelligible to humans. When 
а computer executes а command in BASIC, it needs to translate this 
command inte a series of machine language commands. BASIC programs 
are therefore considerably slower than machine language programs 
bot easier to vrite. 


Assembly Language 

The human shorthand representation of the machine Language 
instructions so that each of the latter instructions can be 
understood more easily. For example, MALT is the assembly language 
equivalent of the machine language instruction 0111 0110. 


А program that translates assembly language instructions 
ily read and understood by human) into machine Та 
instructions (which can be understood by the computer eg the 
Spectrum). 


Read Only Memory (ROM) 

А long machine language program usually known as FIRMWARE; a 
program that has been FIRMLY built into the hardware of the 
computer; it will remain there even when the pover is off. For the 
Spectrum, the ROM is in 280 machine code, and was written 
specifically for it. The ROM of Spectrum occupies from memory 
locations 0 to 16383. You cam only refer со the contents of these 
locations, unlike the rest of memory which you can refer to and 
change as desired. 
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BASIC Machine Language Concepts. 


WHAT IS THE CPU? 


ТЕ we want to communicate with the computer ме have to know what 
sort of commands it will accept and what language the brains of the 
machine (the CPU) talks. 


Unless we know what sort of information the CPU understands we 
can't really instruct the computer to perform remarkable tasks from 
being a chess partner to an accountant looking after our accounts. 


The CPU is по big mystery. 1 like to think of the CPU as a lonely 
little fellow, sitting in the middle of your Spectrum, being ask to 
do things all the time. 


Especially caleulatio 


But the poor fellow doesn't even have a piece of paper and pencil 
to keep track of what Is happening. How does he do it? 


The design of the CPU: 


At this stage, I should probably tell you about the vay that the 
designers of the 280 see things, and how the CPU is supposed to 
handle them. The CPU has been designed to do extremely simple tasks 
only, but he is able to do those tasks very quickly. 


We mentioned above that the CPU дон 
and that is 
remember or 


n't even have pencil and р 
art of the design of the CPU. Any number he can't 
track of has to go in a box for safe keeping. 


Let us look at one example - say you want the CPU to work out the 
fime in NEW YORK, knowing the time in LONDON. 


Now given that the CPU doesn't know anything, first of all you have 
to tell it what the time in London is: say 10 o'clock. The CPU has 
nowhere to keep this information and doesn't know what you will ask 
it to do next, so it puts that information away in а box, say box 
n. 


Then you have to tell ít the time difference between New York and 
London, say five hours earlier, and it puts that avay in box 42. 


Comes the time for calculations, it races across to box #1, gets 
the number, goes to box #2, performs the calculation, and puts the 
result away, say in box #3. 


jo. 46 


n 


The answer of course is 5 o'clock. 


АП of this racing between boxes, adding, substracting and so on 
would be extremely tedious if the CPU had to do it all in its-head, 
so it does exactly what you or 1 would do - it counts on its 
fingers and toes. 


The CPU's hands and feet are called Registers. 


The 280 chip im your Spectrum is remarkable in that it has a lot of 
hands and toes - but we will get to that later. 


To illustrate how exactly the CPU calculates the time difference in 
the above exercise, let's call one of the CPU's hands "HAND A". How 
does the CPU manipulate the contents of the box #1 and box #2? 


The following sequence is pretty close to what the CPU would 
actually do given the above instructions 


* Count out the value of box #1 on the 
fingers of Hand A; 


* Subtract the contents of box #2 from what 
ће has already on his fing 


Look at the value оп the fingers of Wand A 
and store it in box #3. 


Now if this is what truly happens, there are some pretty phenomenal 
conclusions to be drawn from this! 


1. The CPU would пос be able to deal with 
а number like 11.53 — it could only 
deal in whole numbers. 


2. The CPU would be limited in its 
calculations to whatever number it 
could count оп its fingers. 


This is indeed true. 
The main consolation however is that the CPU has а lot of hane 


feet amd can count on each of them separately, and that it cam 
count to 255 using only the B fingers of Hand A. 


and 


We will deal in the next chapter with the details of how the CPU 
can count up to more than 8 on each hand while we can only manage 
10 using two hands! Suffice it to say that each hand can count to 
255 and each foot can be used to count to over 64,000! 


The time difference exercise above has still mot been represented 
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in anything like the language the CPU understands - all we have 
done is describe the processes. 


To let you have an early look into the exciting part of machine 
Language programming, let's now use mnemonics (Abbreviations) to 
instruct the CPU at each ste 


SETTING UP: 
1D — (BOX в), 10 Load box | with 10 
ш (xD. 5 iload box 2 with 5 
CALCULATIONS: 
шю л, (OX #1) iload A with box 1 contents 
SUB А, (вох #2) isubtract contents of box 2 


STORING THE RESULT: 
р (BOX #3), А по 


box 3 vith A value 


These instructions may seem a little ке 
mnemonics are mnemonics. 
"LD" is an abbreviation for LOAD so that 

io Ad 
for example, would mean load A with 1: that is count off ‘one’ on 
the fingers of hand А. 


је at first, but after all, 


Ме also use a rather clever image in these mnemonics by the use of 
brackets: THE BRACKETS ARE USED TO INDICATE V: WISH TO DEAL WITH THE 
CONTENTS OF WHATEVER 15 INSIDE THE BRACKETS. 


It should be fairly easy to remember this on а visual basis because 
brackets do look like they are meant to indicate а container. 


So running through the mnemonics above, we load the contents of Box 
#1 and #2 with 10 and 5, ...etc... to pet the final result of 5 in 
box #3. 


AIL of this is fairly simple to follow and Т am sure you can 
understand that while you аге doing this calculation, the numbers 
on Wand "A" are used to represent the time in New York. A minute 
later they may be used to represent the number of employees in a 
company, and at some other time how much money you have. 


If you are used to the concept of variables from your BASIC 
programming, you must leave that behind in machine language 
programming. 


The fingers of Hand "A" are mot a variable in the same sense as in 
4 BASIC program. They are merely what the CPU uses to count with. 


ONE OF THE BIG DIFFERENCES IN PROGRAMMING IN MACHINE LANGUAGE AND 
PROGRAMMING IN BASIC IS THIS LACK OF VARIABLES. 


в 


You may realise that you can think of the BOXES we use to store 
information as being similar to BASIC variables if we gave each one 


Yes, you are absolutely correct, but these are not variables 
either. They cam be immensely useful and perform similar stor 
purposes to variables, but bear in mind that these boxes are no 
mote than mesory locations set aside Гог a specific purpose. 


The way the CPU copes with negative numbers is different, and ме 
Mill look into that later. 


What if the CPU runs out of hands? 


1 should mention here that you would probably find the CPU a very 
Strange looking fellow were you to meet him in the street. 


Wis hands have eight fingers each, and he ћи 
has two feet, but each foot has 16 toes, ar 
with his toes! 


eight hands! He only 
ће is extremely agile 


He із therefore vell suited for the large number of calculations ће 
is required to do, keeping track of all the numbers on his fingers 
and toe 


Nonetheless, de is possible that in some cases the CPU will not 
have enough hands to do the calculation it wishes to perform, or 

on or other the programmer vill wish the CPU to 
stop in the middle of calculation to do something else. 


The CPU can't just put the information away in boxes, because then 
it would have to keep some hands free just to keep track of which 
boxes it put the information in! 


The 280 CPU gets away with using a stack, which is one of thos 
tall spiky things that some people keep on their desks to store 
bills, spare notes, etc. 1 am sure you have seen those stacks: 
where you spike one piece of paper on, and then the next опе, а 
во om. It's a great filing system if you want the top piece of 
paper only, but very inconvenient if you want one in the middi 
because you have to riffle through all the pieces of paper оп the 
stack. 


Аз it happens, it's a very convenient system for the CPU because it 
fever only needs to look at the top piece of information. 


Whenever an interruption causes the CPU to stop doing its 
calculations, it PUSHes all the information it has on its hands 
onto the STACK, and as soon as the interruption is over, it POPS 
the top bits off, and continues with its work. 


м 


Та computer terminology, ме call this spike a "STACK". When we put 
а piece of information оп the stack, we "PUSH" it on, and vhen we 
get it off, ve "POP" it off. 


ALL kinds of information can be "PUSH"ed and "POP"ed оп and off the 
stack - for example in the middle of a complex calculation the CPU 
may wish to save all the information on its many hands and feet, 
and this would then involve many separate "PUSH"es. To retrieve the 
information, there then needs to be many separate "POP"s. 


For reasons best know to the designers of the 280, our CPU likes to 
keep the stack stuck со the ceiling. This means that the more 
information is "PUSH"ed onto the stack, the further the stack grows 
downwards. 


The main advantage of using the stack to store temporary bits of 
information is that the CPU does not need to remember which box the 
information is im ~ it knows it is the last piece of information 
UPUSW"ed on the stack. Naturally it needs to be a little bit 
organised if there are many bits of information to be PUSHed and 
PoPed. 


What can the CPU dot: 


1 think it's worth considering at this stage the type of 
instructions that the designers thought it would be useful to have 
boilt into the 280 chip. 


Because the СРО has to be able to Кеер track of all its 
calculations on its fingers and toes, there are only two kinds of 
mumbers the CPU can deal with: 
+ one handed numbers - ie numbers you can 
count on ове hand 
+ two handed numbers - ie numbers you can 
count off on two hand, 
You may find this difficult to believe, but the CPU cannot deal 
with numbers larger than those it can count on two hands! 


The types of instructions the СРИ can perform are also very 
limited: 
^ counting off mumbers on one hand 
+ counting off numbers on two hands 
+ adding, subtracting, increasing, decreasing, 
ог comparing one handed numbers 
* adding, subtracting, increasing or 
decreasing two handed’ numbers 
* various manipulations on one handed 
numbers - eg making the number negative 
+ making the CPU skip to another part of 
the prog 
trying to communicate one handed numbers 
to and from the outside world. 


as 


1 am sure you will agree that this is a very limited set of 
instructions, and yet using only such limited instructions you can 
get the CPU to play chess, or to work out your wages! 


Note that even such simple instructions as multiplication do not 
exist! If you need to multiply two numbers in machine language you 
have to write a program to de so. 


This is why writing programs in machine language is so much slower 
than writing programs in BASIC - you сап only do things in tiny 
little steps. 


SUMMARY: 


Registers 

The CPU has а musber of registers it can use for calculations. 
Eight of these can be thought of as the CPU's hands, and two of 
these can be thought of as the CPU's feet. Each ‘hand’ has eight 
"fingers', while each test! has 16 ‘fingers’, 


Memory Locations 

The CPU can transfer information from des hands into or from 
amy other other hand, and into ог from memory. 

Specific memory locations can be set aside by the programmer to 
represent specific information. 


The Stack 

The CPU cam use the stack to transfer information the 
programmer may wish to store temporarily, Information is 
transferred to the stack by PUSHing the information on, and is 
retrieved by POPping the information off. 


Possible Instructions 
The kinds of instructions the CPU is able to perform are only 
lest type of information transfer and simple arithmetic 
calculations. All prograns must be made up of series of these 
simple instructions 
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‘The Way Computers Count 


We mentioned previously that the CPU was able to count to 255 using 
Only eight fingers. How can this be when with 10 fingers we can 
only manage to count to 107 


It is certainly пос because computers are smarter (they aren't) but 
because the CPU is more organised in its information tham we ar. 
why should raising your index finger have the same value ( = 717) 
as having your little finger raised? 


It seems obvious that if you so wished you could represent two 
different numbers in this way. 


1t is very much the same sort of thing as realising that the number 
001 is different from the number 100. The plain truth is that 
humans are mot very efficient in the use of fingers for counting. 


The CPU understands that mot having a finger is of some information 
and that which finger is raised (в а valuable piece of information. 


With only two fingers it is po 
0 to 3, as follow 


ible to devise à vay to count from 


e 


representation ll (or two 
fingers) have the value 3. 


We could just as easily have chosen a different representation. 
There is a direct relationship between this and binary 
Representation. The CPU"s fingers are locations in memory and they 
сап be made to indicate on ап off ( ог "0! and 'l' as convention 
dictates). 


ТЕ we added a third finger to our example above we could represent 
all the numbers from O to 7. Three fingers for all the numbers 
from 0 - 7! 


Four fingers vould be able to represent all the numbers from 0 to 
15! ТЕ you don't believe it, it would be a good exercise to write 
out all the possibilities for four fingers being rais. 


In order to simplify the notation of such numbers, and to avoid 


confusion in trying to write down the mumber eleven as opposed to 
indicating that two bits were set, a universal convention has been 
adopted: 


The mumbers 10 — 15 are indicated by the letters A — 


Decimal — do 
n 
12+ 
13 
n 
15 


„ebe 


This means ме write the numbers from 0 to 15 decimal as 
01234567829 ABCDEFP 
Simple, isn't it? 


This way of treatiog numbers is called the HEXADECIMAL FORMAT. 
To prevent confusion, some people write "Н" after а hexadecimal 


10H). The "H has no value, but serves to remind the 
hexadecimal convention. 


In machine language programming, it is CONVENIENT to dei 
numbers In hexadecimal format. 


vith 


This із only a convention and if you so wished you could write all 
your instruction in normal decimal format. It із convenient for us 
to use the hexadecimal format because: 


1. ft is easy to convert from this form to binary, 
which tells us which bit (or finger) is doing вас. 


2. dt gives us an easy means of seeing whether numbers 
аге one handed or two handed - le В-Ы or 16-bit. 


3. It standardises all numbers to sets of 2-digit 
numbers. (We will elaborate on this) 


4. 1t їз the common convention and familiarity with 
hexadecimal will allow you to read other books and 
manuals more easily. 


5. As the CPU is designed to process information 
represented by binary numbers which are cubersome 
for humans to read, ме need а representation which is 
more easily readable. 


Bot it is only a convention and not а sacred rule. 


The hexadecimal system, as ve mentioned earlier, lets us represent 
the numbers O to 15 using only 4 bits. Any B-bit memory location 
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or B-bit register can therefore be described by two sets of 4 bits. 


(This 15 the same as saying that any combination of 10 fingers can 
be represented by two hands of 5 fingers each.) 


THE REASON МЕ ARE CONCERNED WITH 8-B1T MEMORY LOCATIONS AND 8-BIT 
REGISTERS 15 THAT THIS 15 THE STRUCTURE OF THE 2X SPECTRUM. 


ALL memory locations and all single registers have B bits. This is 
mot hard to understand - it's like saying all humans have 5 fingers 
оп each hand. 


Taking thi 
Fingers first: 


come familiar with 4 


опе step at а time, let us 


For those of you with a mathematical bent, you may notice that the 
mumber each finger represents is multiplied by 2 as you go to the 
left. 16 we mumbgr the fingersi 


then the value of each fing 
finger number. Let's call 
small cigar is a cigarette 


г is '2 to the power КҮ where N ii 
leger hand a "handler" (just 


Exercise: 


What decimal and hexadecimal value do the following arrangement of 
bits (or fingers) represent? 
Decimal Hexadecimal 


ооо 
опо 
1001 
1010 
1100 


1t is important for you to become familiar with the hexadecimal 
convention, and if you had difficulty with the concept, do read the 


last few pages again before going on. 


Let us examine what happens if we want а number greater than 15? 
Say 167 We would use the next finger on the left, as: 


= 16 decimal = 10H (Hexadecimal) 


The reason we write the number as 109 is that we divide the hand 
into two "bit handlets". We can therefore easily denote each 

indlet by one of the hexadecimal numbers representing 0 to 15 (0-9 
& MD. 


In this way any B-bit hand can be written as exactly two 
hexadecimal handlers: 


1 


One 
Hexadecimal 
Digit 
E 
Tes 
Hexadecimal 
Digits 


The "handlet" on the left indicates le times as much as the 
"handlet" on the right. This is much the same way as in decimal 
notation, the digit in the "tens" column is worth ten times as much 
as the digit in the "ones" column. 


We convert numbers in decimal format such as 15 automatically to: 
15 = (1410) + 5 
This is so automatic that we don't even think about it. 


lt is exactly the same thing in hexadecimal notation. To convert 
back from hexadecimal notation to decimal notation, ve multiply the 
hexadecimal number on the left "handlet" by 16. Using the example 
above: 


108 = (1816) +0 
= 16 Decimal 
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This is һом we are able to count to 255 using only 8 fingers. The 
maxisus [s obtained when all fingers are held up: 


тен ele, 
= (15916) + 15 (in decimal) 
= 255 (Decimal) 


The smallest number is when no Fingers are held up: 


Фон = 0 Decimal 


Note that all numbers, from the smallest to the large 
and only 2 digits to define the number. 


Try out for yourself any combination of 8 digits and see if you can 
convert it to hexadecimal notation, and then into decimal notation. 


It may seem a little strange and awkward at first, but you vill 
soon get the hang of it. 


Also that when you count in hexadecimal, you do the same 
decimal: 


Decimal: 26 27 28 29 зо ete. 


Hexadecimal: 26 27 28 2% 2л 28 2с 20 
ЗЕ зо 30 еке..... 


The values of the mumbers in the decimal and hexadecimal series 
above have different values of course, Note that after 298 you get 
2A, not зон! 


The following BASIC program vill enable you to input to your 
Spectrum а decimal musber and convert it to à 
hexadecimal value. 


100 REM decimal to hexadecimal conversion 
110 PRINT "Please input decimal value," 
120 INPUT n : PRINT n 
130 LET S$ + "" 135 LET п? = INT (а/16) 
140 LET nl = INT (n - n2#16) 
150 LET S$ = CHRS ((nt (= 9) * (n + 48) + 
(nt )9)*(55 + 91) + S$ 
160 IF n2 = О THEN PRINT : PRINT "HEXADECIMAL = 
= 1 TO 200: NEXT I: RUN 
170 LET в = n2: 00 TO 135 


Try converting the following numbers to theirs hexadecimal value 
amd use the BASIC program to test your answer. 
i. 16384 address of the start of Spectrum 
display file 
ii. 22528 memory address of the start of Spectrum 
attribute file 
iii. 15360 memory address of the start of Spectrum 
т set 


iv. 13616 of the start of ASCIT 
characters in Spectrum 

SUMMARY 

Decimal 


The decimal notation ts а convention of counting numbers in 
groups of ten units at a time. These are represented by O, 1, 2, 
4, 5, 6, 7, 8, and 9. 


Hexadecimal 
The hexadecimal notation is a convention of counting numbers 


in 
groups of 16 units at a time, These are represented by 0, 1, 2, 3, 
4. 5, e. 7, В, 9, А, B, С, D, E, and f. 

Sometimes an H is added at the end of a hexadecimal number to 
remind us it is written in this format. For example, 1800H. 


‘Bit Memory Locations 

The ZX Spectrum is designed so that each memory location has B 
bits (‘fingers’). Each memory location can store a number from 0 to 
255 decimal. This is conveniently represented in the hexadecimal 
format as a two digit number. 


How Information is Represented 


There is a big difference in information representation between 
human and computer. Human information is mainly composed of numbers 
and characters (alphanumeric information), whereas all information 
im a computer 18 stored as groups of bits. 


A bit stands for Binary digIT (90% or "1"); in the 2804 
microprocessor, these bits are structured in groups of eight. A 
group of eight bits is called a BYTE. 


This way of representing information using binary digits is called 
the BINARY FORMAT. This is the structure of the language which the 
280 and most microcomputer CPUs talk. 


Basically, there are two types of information represented inside 
the Spectrum. The first one is the PROGRAM. The second one is the 
DATA on which the program will operate, which may include numbers 
ог alphanumeric text. Ме will thus discuss below these thr 
representations: PROGRAM, NUMBERS, and ALPHANUMERICS 


Program Representation 


A PROGRAM is а sequence of instructions to the CPU to perform а 
particular task which can be broken down into a number of 
Ngub-tasks” 


In the 280, all instructions are represented internally as single 
or multiple bytes. Instructions represented by one byte are called 
the "SHORT instructions". Longer instructions are represented by 
two or more bytes. 


Because the 280 is an eight-bit microprocessor, it can only deal 
With one byte at а time, and if it requires more than опе, it 
fetches bytes successively from memory. Therefore, а single-byte 
instruction will tuo- or 
three-byte instruction. Thus, as it ís always more 
efficient to write your machine language program using single-byte 
instructions where possible. 


You can turn to the instruction set table in the Appendix and have 
а look at the SHORT and LONG instructions. Don't worry if you can't 
understand them, we will discuss each instruction in depth later 


Numeric Data Representation 


* Integer Representation 


We discussed earlier that because of the way the 280 is designed we 
cannot have a number such as 11,53. The CPU can only deal in whole 
numbers. Also, by using only 8 fingers (le ап &bit number), we 
could represent all the numbers in the range 0 to 255. 


e.g. decimal 255 is represented by ОРЕН 
the binary 


But vhat about megative numbers? 


* Signed Integer Representation 


D 
represented by holding different fingers up. 


mber one byte is 


WAND with eight fingers and a number is 


Obviously, to represent signed integer in Binary Format, we have to 
have some vay of senting а positive or negative numbers. Let's 
y that in order to represent a negative number, we adopt the 
Following convention (signed representation): 


A NUMBER ON THE CPU'S HAND WILL BE CONSIDERED TO BE A NEGATIVE 
NUMBER IF THE CPU HOLDS HIS THUMB UP. (in computer terminology, the 
highest bit = bit 7 is on.) 


So we have only seven fingers (bits) left to represent the value of 
the number. That means the highest number we сап have is по long 
255. Im fact, half of the numbers which сап be held on а single 
WAND (a single byte) will be negative and half of them will be 
positive (depending on whether the thumb (s up or not). 


The total number range possible on one hand if ме allow negative 
numbers will therefore be from -128 to +127. (Note that the total 
number range that can be represented will still be 256 numbers). 


Now comes the crunch: When is a number with the thumb up a 
positive number and when is it a negative number? 


The answer is whenever you feel like it; You have to make a choice: 
numbers can either be in the range of 0 to 255 or in the range 
-128 to +127. They can't be both at the same time! It is up to 
you, the programmer, to decide which convention you are using at a 
particular time. 


АТА the instructions will work equally well, whether you choose to 
let the number contained іп the registers or memory be all positive 


or positive and negative. 


+ Choosing a Representation for negative numbers. 


We have already decided that holding the thumb up will mean the 
number is negative, and mot holding the thumb up means it is 
positive. Is this enough? 


No. We need to decide which of the 127 possibilities of the 
remaining 7 fingers will denote -l, which one -2, and so оп. 


We need а representation of negative numbers, such that when а 
umber is added to its negative we get zero. As ап execise, let's 
think about the number which when added to | gives us zero: (This 
Mill obviously be I, and we already know that the thumb - bit 7- 
will be up) 


о 
could ít bes)? 1 
1 


9000 0000 


Let's try 1 000 0001 - in other words, the same as «1 
with the thumb up. To test if that is -l, let's try adding this 
value to +1. From above the sum 10000010 is obviously not the right 
answer! If it vas right, the answer would have been 0000 000 
0. Obviously, we need а number that will take that carry from Bit 
o, and convert it to zeros all along. 


You can try to do it yourself, and you will see that the only 
number which will give us the right answer is 


капа LILI (FH in hexadecimal) 


To confirm this: 


(carry) 0000 0000 


Is there a way that we can work out a general rule for the negative 
of amy number from this example? It looks as if though ме might 
have to get the opposite of the number and add one at the end. 


Let's try this rule on another number, such as 3, say: 


(ғо) 


Let's add to this number to 3 and see what happens: 
0000 0011 


“-- 
(сату) 0000 0000 Те works! 


Ме have found a мау to represent negative numbers! 
1 =) FF 


The largest positive number is 
0111 1111 = JF =) 127 Decimal 
and the negative of this is 


1000 0001 = 81 =) -127 Decimal 


The real test of this rule is to see |f by applying the rule to a 
negative number we get back the positive again! 


Let's try it out өп -3 which we worked out above is РОН. 
Number 1111 1101 
Opposite 0000 0010 

0000 0011 


лав 1e) 23 


This is therefore a representation that works! We can apply it to 
кес the negative of any number, 


16 ~ bit Negatives 


Exactly the same reasoning applies to two hand 
number 


numbers (16-bit 

), except that the thumb of only one hand needs to be shown 
ав "ОН" to indicate if the number is negative or пог. (ie. bit 7 of 
the high byte). 


Convention: 


The computer terminology for this convention is called TWO's 
COMPLEMENT. You can find 2's complement tables for negative decimal 
numbers at the Appendix of this book. 


Remember that this is only а convention! You still have to decide 
at all times whether the numbers you are using are meant to 
designate numbers in the range 0 to 255 or numbers in the range 
-128 to «127. 


Exercise 


i. If 127( 0111 1111) is the highest positive 


т 


mumber which can be represented in this convention, 
how would you represent -1287 
ii. Find the highest positive 16-bits (TWO HANDS/BYTES) 
the highest 16-bits negative number? ш. 
Find the 2's complement of the smallest 
16-bit negative number 8000H. Why is it 8000H? 


Alphanumeric Data Representation 


Sometimes, in machine language we do not want the numbers to be 
instructions for the computer, nor do we want them to be numbers 

for calculations. ме may just want them to represent characters of 
perhaps 


Our convention to repi 
pretty straightforward: all cha 
с ted оп a single hand (ie in an eight-bit code). 


Та the computer vorld, there are two standards Гог alphanumeric 
characters representation: The ASCII Code, and the EBCDIC Code. 


ASCII stands for “American Standard Code for Information 
Interchange" and is universally used in the microcomputer industry. 
EBCDIC is a variation of ASCII used by IBM. 


Im the ZX Spectrum, alphanumeric characters conform to the ASCII 
standard except for the pound (61H) and copyright (ТРН) characters. 
You can find an ASCII conversion Table іп the Appendix. Compare it 
With the character set table in appendix A of your Spectrum manual 
pp 183-186. 


Try ele PRINT CHR$ 33 
and you will get a "t; because "I" As 
represented internally by 21M. 


WELP!: We have just shown that the CPU's hand can be said to show а 
—— variety of things: 
lt could be - а program instruction со the CPU 
= а number in the range 0 to 255 
=a number in the range - 128 to + 127 
= part of a two handed number 
= am alphanumeric character 


This is all true, and it is up to you, the programmer, to remember 
just what it is the CPU's hand is supposed to be holding 


SUMMARY: 


Memory Contents 

Тһе Spectrum's memory can store programs, numbers, or text, as 
we desire. There is no way of telling which is which just by 
examining the contents of a single memory location. 


Programs 

Program instructions are stored in momory as sequences of 
bytes. Some instructions require only one byte, while others 
require up to four bytes. 


Numbers 

Each memory location can be used to store either positive 
Integer numbers or signed integer numbers (numbers which can be 
positive or negative), as ме choose. The range of numbers is either 
from 0 to 255 or -128 to «127. 


Negative Numbers 

А convention has been adopted that when we choose to have 
memory store a signed (+ оғ -) number, the following rule shall 
apply: 

1f bit 7 is on, the number is negative 

1f bit 7 is mot on, the number is positive 
To obtain the negative of any number, get the 

TEM 


"2's complement" and 


27% Complement 
The 2's complement of any number is its opposite in binary 
form. Any bit that is on becomes off, and vice ver 


ALookintothe CPU 


Introduction 


We have said that the brain of the Spectrum is the CPU, the 7804 
processor. This is a faster version of the 280 processor produced 
under a licence from Zilog Inc. 


The only difference between the 280 and 280A processors is that the 
former processor 1s running at a clock speed of 2 Mhz/s (Megahertz 
per second) while the later processor 15 running at a clock speed 
of 3.5 Mhz/s. "Clock speed’ is merely a measure of how fast the CPU 
is performing its calculations. In the Spectrum, 3.5 million clock 
pulse signals are generated per second, ie one clock pulse every 
0.000000286 of a second. 


The fastest instruction the CPU can perform takes up 4 clock 
pulses, while the slowest requires 21 clock pulses. That means, 
that even if all instructions performed are the slowest one: 
160,000 instructions can be performed 


bout 


A Physical View of The Brain 


or in the Spectrum is a silicon chip with forty pins 
from | to 40. These pins are the communication lines 
between the processor and the rest of the computer. For exampli 
the processor draws its power from the power supply through pin 11, 
jets its clock signals from pin 6, sei 

through pins | to 5 and pins 30 to 40, and sends data in or out 
through pins 7 to 15 except pin 11. The rest of pins ai 

control signals communication, 


find yourself totall: But по пе 
it's really to our advantage that we don't know the 
structure of the machine, and we don't need to know it to 
capabilities. It's just the капе as with a calculator. The 
physical structure of the machine is 'transparent' to the users (in 
other words ve don't see it!). We are only interested in the 

logical structure of the calculator, or in this case the 280 chip, 
amd how ме cam use it to our purpi 


Logical View of The Brain 


Logically, the 280 cam be divided into five functional pai 


They are 1. the CONTROL UNIT 
iil the INSTRUCTION REGISTER 
111. the PROGRAM COUNTER 
iv. the ARITIMETIC-LOGIC UNIT 
У: the 24 USER-REGISTERS (the usable HANDS 
and FEET of the CPU) 


+ CONTROL UNIT 


We can see the CONTROL UNIT as a supervisor for the CPU's 
Processing. Its task is to time and coordinate the Input, 
Processing, and Output of the particular job that the CPU is being 
asked to perform, whether the instructions come from the ROM 
program, or from your progr: 


+ INSTRUCTION REGISTER 


This is а HAND that the CPU uses to hold the current instruction 
that de is going to perform. The whole task which comprises a 

ide somewhere in memory ~ either in the ROM or in 
(Random Access Memory). You may recall that a program is a 
sequence of instructions. Thus, to perform the task, the CONTROL 
UNIT has to fetch each instruction in turn from the memory (either 
ROM or RAM) and place it in the INSTRUCTION REGISTER HAND. 


* PROGRAM COUNTER 


This is really one of the 280% FEET which tell the CPU where the 
next part of the program is (the address of the next memory location 
from which the CONTROL UNIT is going to fetch an instruction). It 

is like an instructions warehouse manager keeping track of the 
location of the next instruction to fetch out. 


+ ARITHMETIC and LOGIC UNIT 


This is the calculator inside the CPU. It can perform both 
arithmetic and logical operations. Out of all the basic arithmetic 
functions as you and I know them, this unit can only perform simple 
addition and subtraction, incrementation (adding 1) and 
decrementation (subtracting 1), but not multiplication or division. 
The unit can also compare one handed numbers, or perform bit“ 
operations such as rotating fingers around, holding specific 
fingers up or down, etc. 


As а byproduct of the calculations the ALU is asked to perform, the 
calculations usually affect the status of the various FLAGS im the 
FLAG register. This is discussed {п more detail further on. 
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+ USER-REGISTERS 


These are the CPU's Hands and Feet, vhich you, the programmer, cam 
control. 


There are twenty four User-registers within the 280 microprocessor 
= some are HANDS, and some are FEET. 


The images ve have been building up of hands, feet and boxes make 
the processes easy to visualise and are а good representation of 
what is going om, but computer buffs tend to look askance if you 
say things like "...and then the computer shifted its information 
from its right hand to its left hand." 


We will now give you the proper names for the CPU's hands and feet, 
so that when faced with that situation, you will be able to say: 
"D њи 


To start off vith, computer buffs refer to the 
the CPU as "registers". 


mds amd feet of 


We mentioned earlier that the CPU has eight hands: these are 
called A, B, C, D, E, Fy .... In our world, the definition of a hand 
18 something with eight fingers. 


The CPU has two feet; these are named IX and ТУ. The definition 
of а foot is anything with 16 toes! 


The naming of hands and feet is fairly easy to follow because if а 
register has only one letter in its name then it must be а hand 
(that is, contains 8 bits), while (f it has two letters in its name 
then it must be а foot (that is, have 16 bits). 


Did you notice the smooth transition from fingers and toes to bits? 
We will have you used to computer terminology in no time. 


Actually the remaining two hands for the CPU after D, E, Р, 


seseeseare not named "C" and "M" as опе would expect but "H" and 


The conventional way to represent all these regi 
follows: 


ters is as 


А 5 
в с 
о Е 
н È 
1х 
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Notice that "F" is paired with "A", but after that the rest follow 
fairly naturally. The reason that registers are paired in this мау 
Is that it is sometimes possible to make a foot out of two hands! 


After all, if the definition of a foot is something with 16 bit 
then maybe we can fake it from time to time and use two 8-bit ham 
to do the work of a foot. We therefore talk about "register pairs 
such as BC, DE, and HL. 


The reason the register pair "HL" was called "HL" instead of 
something like "CH" was to help people remember which of the two 
registers had the high number and uhich had the low number. 


It's as if though you wished to represent the numbers 0 to 100 on 
your hands and toes. You can easily set up your fingers to 
represent the numbers 0 through 10, and similarly with your toes 
(assuming that you are agile enough). One мау you could denote the 
number 37 in this way would be to count off 3 on your fingers and 7 
ов your toes. But there has to be some agreement on vhich is the 
high number and which is the low number otherwise someone else 
might think you meant to represent the number 73. 


The "W" im "HL" stands for MIGH and the 
there is no chance of confusion - right? 


stands for LOW, so 
This diagram of register pairs also serves to indicate which 
register in the other register pairs contains the high number: 


B in вс 
D in DE 


because all the highs and lows are treated in the same order. 


The feet (IX and IY) also have a special name: they are called 
"index registers". This has а lot to do with the fact that they 
can be used to organise information in much the same мау as а book 
index 18 organised. Alternatively, you can view them as table 
pointers. 


OK, now that you understand the terminology, here are some special 
points: 


THE ACCUMULATOR ( A register) 


This 8-bits (single byte) register is the most important register 
of the 280. Its name dates back to the early generation of computers 
when there was only a single register that could be us 

‘accumulate’ а result. 


So, as we have advanced from the early generations of computers, 

the accumulator continued to be used extensively for logical and 
arithmetic operations. In fact, most computers are still designed in 
Such a мау that many operations can only be performed using the A 
regist 


This is true of the 280 chip, and the A register is a favoured 
ister. You can think of the A register as being like the CPU's 
that most people can perform some t 
more easily with their right hand than with the left hand. 


The Flags: 


Please note that "AP" is not usually treated as а rej 
The "P" in this case is used to denote "Flag Regis This is a 
hand with В fingers such that each finger indicates whether a certain 
condition {в met or not met and ме will be dealing with this in a 
Separate chapter. 


ter pair. 


Of the three register pairs (BC, DE, ML), the HL pair is probably 
the most important one. Besides giving the user the option of using 
it as two single registers or as a register pair, the 280 is 
designed ín such a way that there are certain 16-bit arithmetic 
operations that can only be performed using the HL register pair. 


Because of this particular hardware privilege, general register 
pair operations usually will be faster using the HL register. This 
makes HL preferable to use in machine language programming. 


Maybe the НЫ register is the CPU's right foot? 


An Alternate Register Set 


1 thought that this might be a mice place to mention that the CPU 
also has a spare set of hands! 


Not really so much a spare set of hands (all right, alternate 
register set, if you want the proper terminology), as a spare set 
of work gloves. 


It's like you had a set of stiff plastic gloves, so stiff in fact 
that they retained the shape of your hand when you took them off. 
ТЕ you had counted off the number 3 on your hand for example and 
took off your gloves, then the glove would still retain the shape 
of а hand vith the number 3 counted off! 


You сап no doubt think of uses for such gloves immediately - you 
could make a mote of a number while wearing one set of gloves, swap 
gloves and the old number would still be there when you needed it 
оп the other set of gloves! 


The other glove is there if you want to use it and it won't forget 
the impression of your hand when you took it off. Unfortunately 
you can't just glance down and see what was the number you had 
retained there. Nor, naturally, can the glove perform any 
calculations without a hand inside the glove! 


You actually have ко swap gloves again to be able to use whatever 
Information the gloves retain. 


The CPU has a spare set of gloves for each pair of hands (but mot 
for feet - who ever heard of gloves for feet?) but they are not 
interchangeable between hands, just as you can't put a left glove 
опа right hand. 


The representation of all the re 


sters de пом therefore: 


АНИ (ums) мым 
в-с (e) Pic 
D-E (=) D-E 
й-1 (=) at-il 
Ix 
iv 


ге set is always indicated with 


Note that the set of gloves you are wearing has the 
the hand ít is for, while the sj 
the dash symbol. 


The instructions still relate to what the hands are doing, ngt to 
which pair of gloves you have on. So although ме show the spare 
set with a dash, there are по instructions such as LD A',l. The CPU 
only works on your HANDS, mot your gloves. 


The only instructions involving the alternate register set are of 
the "swap gloves now" type. For example: 


1. LDA, (Box #1) ad А with contents of 
x #1 


hort for exchange — 


2. EX AF, АР 


ie. swap gloves on АҒ 
ith those of АР 

3. LD А, (Box 42) E 

4: EX APT! Another exchange 


5. № A,(Box #3) n 


You will mote that in the above 5 instructions there are по 
instructions which have specifically affected the alternate 
register set but we have without doubt altered their contents. 


This example is designed to illustrate the concept of the alternate 
register set. Try to work out what is happening. 
Do you know what will be in register "A" after each instruction? 


For simplicity's sake, let's assume that the contents of the three 
boxes are as follows: 


(Box #1) = 1 
(вох #2) = 2 
(Box #3) 3 

Then the following is what happens after each instruction: 


Register А" 


i ot known 
2. 1 
x 1 
à. Ж 
5: 2 


Really quite simple, isn't it? 


You will find that these EXCHANGE registers are particularly useful 
when you run out of НАНОв, run out of registers and you don't want 
to spare your hands/feet by storing what is on them onto the STACK 
or into MEYory. We will follow through this point 


Even More Registers? 


Yes, there are even more registers, but you will probably mot be 
using these to any great extent. 


The STACK POINTER 


The STACK POINTER is another foot the CPU has (2-byte addressing 
register). 


1t always points to where the pile om the stack has got to. As the 
stack grows, it grows downward [rom high memory locations 
memory locations. 


You ёо not usually have to do anything about the Stack Pointer in 
Hachine Language programming. The CPU looks after it, and updates 
it every time you do а PUSH or POP. 


Note that it is а common mistake to forget to POP back a value that 
you PUSited on to the stack. You сап be sure that this will cause 
your program to "CRASH". 


The 1 Register 


This is the Interrupt Vector register. In 280 based systems other 
than the SPECTRUM this register would normally be used to hold the 
base address of a table of addresses for handling different 
responses to am interrupt, for example, Input/Output request 


However in the SPECTRUM this facility is пос us 
register is involved im generating T.V frame 
unlikely you will ever have to use this registe 


The керін 


The Я register is the memory-tefresh register. 
the 280 to refresh dynamic memories automatically. As the 280 
processor (+ doing its job, the information stored in those parts 
of dynamic memory which haven't been accessed recently will "leak" 
away because of а drop of voltage through time. Unless these memory 
locations are refreshed (recharged), information stored originally 
WiLL disappear! 


Tt (а provided in 


Тһе R register serves as a simple counter that is incremented every 
time а memory information retrieval cycle" occurs. The value in 
the R register thus cycles over and over from 0 to 255. 


This can be used by the hardware to ensure that all parts of the 
memory are 'refreshed'. But don't worry - you never need to know 
about it. That is something that Иг. Sinclair had to worry about 
when he designed the Spectrum. We can just make use of his computer 
without ever worrying about refreshes, etc. 


From a programming point of view, you can think of the R register 
as relating only to hardware and system usage. But sometimes you 
can use it as a mean of obtaining а random number between О and 
255. Ve will demonstrate this usage later. 


SUMMARY: 


User's Registers 

There are eight main B-bit registers in the CPU (A, Р, В, С, Dy 
я, L), and two 16-bit registers (IX and IY), Fight-bit registers 
have only one letter in their name, while 16-bit registers two 
letters. 


Register Pairs 
Six of the eight S-bit registers сап in some circumstances be 
used im pairs to operate on 16-bit numbers. 
These are the BC, DE and EL register pairs. The name HL can 
serve to remind us which is the High order byte and which the Low 
order byte. 


Preferred Registers 
Тһе 280 CPU (а designed im such a мау that some 8-bic 

Instructions can only be performed by the А register, while sone 

16-bit instructions can only be performed by the НІ. register pair. 


Alternate Register Set 
The eight main B-bit registers с 
talternate’ set of registers. 
The values stored in the main registers are retained by the CPU 
while the alternate set 19 being used, but cannot be accessed. 
(changing the register sets again allovs us to operate on 
original values again. 


n be swapped with another 


You have probably heard enough about the CPU and hexadecimal 
notation, and it all seems so irrelevant, It doesn't explain how 
you actually RUN a machine language program. 


The ZX Spectrum is actually running machine language programs ai 
the time! (When it's on). It's just that you are not aware of it. 
Even when you're mot doing anything, Just watching the screen, 
trying to think of what to enter as the first line of your 
revolutionary BASIC program, the Spectrum computer is busy running 
under the control of а machine language program. 


This program is the one that is stored in the ROM chip and is 
referred to as "the operating system’. For example, the part of 
the program that is running when you're sitting there looking at 
the screen does the following things: 

Scan the keyboard for entry 

Note that no key has been pressed 

Display the present screen (empty) 


Even when you are running a BASIC program, the CPU is still under 
the instruction of the machine langua ram. This program is 
of the ‘interpreter’ type as we have alread exlained: it looks at 
your next BASIC instruction, converts it to machine langua 
executes that part of the program, and then returns to interpret 
the next. instruction. 


ALL this stops 
program! 


Ang true when you run your own machine language 


Total freedom from the operating system! Тһе use of the "USR* 
fonction hands over total control of the CPU to whatever comands 
you have placed at the USR address. It will interpret whatever it 
finds there as valid machine language instructions. 


This can be pretty terrifying as you could lose everything stored 
in memory should you lose control. One error, one wrong character, 
amd you will have to turn the Spectrum off and start again from the 
beginning. 


There are no error messages to catch what you have done wrong, no 
syntax checking for incorrect statements - so if you make the 
slightest error, the hours of work you put ín to enter your prograr 
could be lost! 


At the end of this book we have included а BASIC program which will 


allow you to enter and edit machine language programs. Once you 
have entered this program on your Spectrum, save it on tape as it 


E] 


is more tham likely that you will lose control of your machine 
language program at least once. 


On the other hand do пос be afraid to experiment — you cannot 
damage the computer with any machine language program you enter. 
The worse that cam happen is that you may have to turn your 
Spectrum off and on again. 


We will now just wet your appetite with the very simplest possible 
machine language program. Load the BASIC "EZ Code Machine Language 
Editor" found at the back of this book and RUN it. 


The program vill ask you for a loading address. This is asking you 
where you will want the machine code to live. With this Е2-Собе 
program, you cannot use an address below 31500, so let's choose 
32000. Enter the number 32000 then press (ENTER). 


The screen will now show: 


Command or Line (46): 
This means the program is waiting for you to enter a command or a 
mew line of machine code. 


Let's enter "1", then а space, then "c" and then "9". This is like 
entering a line of BASIC numbered line number 1, but it is a line 
of machine code. If everything (в OK, then press (Enter). The 
screen should пом show you all the lines you have entei 


1 е 


and at the bottom of the screen the prompt 
‘Command or Line (% 


At this stage you do mot want to add any more lines, so let us 
enter a command instead. 


Enter the vord "dump", and then press (ENTER). What this command 
does is to dump the machine code in the listing into the addres 
you have specified, namely 32000. 


Congratulations: you have Just entered a ome instruction 
machine language program! You сап check this was entered correctly 
by now entering the command "men", followed by (ENTER). This 
command allows you to examine memory, and it will ask you for а 

ting address. Enter 32000 then (ENTER). 


Yow vill see the contents of memory locations from 32000 through to 
32087. All should show 00, except 32000 whích will show C9. Press 
key "m" to return to the main command input stage. 


What the instruction "C9" means is: RETURN! 
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It's a little Ике riding a bicycle for the first time: you really 
want to be let loose on your own, but as soon as you go a little 
way you vant to "return" to the safety of earth (or operating 
system as the case may be). 


Now ме rum the machine Language program. To run any machine 
Language program you have dumped to memory, enter the command "rur 
followed by (ENTER). 


What happened? Why did the screen come up with 32000 at the bottom 
of the screen? This was the address used as the loading address you 
used at the start. 


Don't forget that the function of "USR" is to execute a machine 
lamguage sobroutine. As part of this function, the value of USR on 
return from the machine language program you placed in memory will 
be the value of the BC register pair. 


The anser lies in the vay the Spectrum operating system (yes the 
same one) deals with the "USR" fonction. 


When the operating system encounters the "USR" function it loads 
the address the user specified into the register pair BC - in this 
сазе 32000. 


The value of "USR", as in 
Let A = USR 32000 
naturally gave the answer 32000! 


This feature of the "USR" function will prove to be a very useful 
опе as it will enable us to monitor what {з happening during the 
running of a machine language program. 


Let us enter the following machine langi 


ов 
© 


The way to enter this short two-instruction program is as follows: 


Enter Line 1 Ob by entering "1", then space, then "O", then "b", 
amd then press (ENTER). Similarly enter line 2 c9. The listing 
should show you that you have entered the lines correctly. Enter 
the command "dump" and then the command "run", 


This time the result will be 31999! This is because the 
instruction "OB" is "DEC BC" (abbreviation for decrease value of BC 
by D. 


Experiment with instruction that involve BC by looking up such 
instructions at the table at the back. Cam you work out what the 
abbreviations mean? 


Be careful to have the last line of all your programs as "c9". This 
is the RETURN instruction, and if you forget it, the program vill 
never return. 


1f that should happen to you, don't worry - your computer has not 
been damaged. Just turn off the power and reload everything. 


Exercise: 


You can use the "mew" command to examine any part of memory. Try 
Various addreses where you think you might find something 
interesting. 
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How the CPU uses Из Limbs 


Introduction 


We have seen that your 2X Spectrum CPU has twenty four Hands and 
Feet. Just which operations are allowed and how easy they are for 
the СРО со perform is the key to machine language programming for 
your Spectrum. 


Imagine for а moment that you are the CPU: 


Possibly like most people, you are right handed and there are 
things you сап do with your right hand that you are mot quite «о 

at with your other hand. There are also certain actions which 
may be e difficult another vay — 
such as picking something off a high shelf with your left foot and 
passing it to your right hand ís harder to do than if you used your 
left and right hands. 


It's the same їп machine language - you can perform some tasks 
easily one way, with more difficulty another мау and it may be 
impossible a third vay. Knoving which combination of actions are 
allowed їз the key to success. 


The equivalent hané on the CPU to your right hand is the 
register. Remember! The ACCUMULATOR, the hand that came into 
existence as а result of genetic inheritence of early compute 


On the other hand (so to speak if you'll forgive the pum) you can 
temporarily store what you have (а your right hand onto amy other 
hand, foot and vice ver: 


Computer boffins refer to this 


But this is just a big пале for saying transfer information from 
one register to another. 


Other examples would be LD A, B 
Ш ще 
and во on. 


Please note that LD is the mnemonic (abbreviation) for "LOAD" and 
that when you read assembly language a conma "," is read as "with" 
Thus we would read 

MLD A, в 
as "LOAD A VITH В" 
An assembly language instruction is read in the same order as a 
normal English sentence would be. 


There are also other combinations or ways other than register 
addressing that information can be transferred from one register to 
another or from register to memory. 


уз you can use the CPU's limbi 


One of the advantages of the 280 processor is the large number of 
and the possible combinations (addressing modes) that are 


Let's look at the combinations offered by the 280: 
Immediate addressing, 

+ Register addressing 

* Register indirect addressing 

* Extended 
= Indexed addressing 


What а list of names? Don't worry, just remain confident and we 
Vill step through them one at a tim 


The list above does not cover all the possible combinations 
possible - only those that apply to one-handed numbers 
Let's deal with each one of these possible contortions in turn: 


Lo . a 

(or other instruction nn example 
We use the abbreviation "ғ! to mean amy B-bit register and "а! апу 
ble number. 


ing is a technique that involves only a single 
hand. The actual data ie a part of the instruction; this means the 
CPU сап execute the instruction IMMEDIATELY it receives the 
imatruetion. ТЕ doesn't need to look in memory to find more 
information in order to perform this instruction. 


For example, count off 215 оп hand "A". 1 am sure you know enough 

about the mnemonics by now to be able to write this as 
ш A, 215 ог LD A, 007Н 

Once again you can do this with any of the registers, with any 

numbers whatsoever. 


The format for the immediate addressing type of instruction is 
shown below: 


byte 1 instruction (telling the computer what 
code is this instruction) 


byte 2 E (the value of the actual 
data for the instructior 


Since there is one byte allocated for the actual data, the 
limitation to the size of number you can specify is within che 
range 0 - 255. If you don't understand this, refer back to chapter 
оп "The Way Computers Count". 


We usually use Immediate addressing to initialis counters and to 
define constants needed in calculations. 


Immediate addressing is easy to use іп machine language 
programming. However, it is the least flexible of all transactions 
(aderessing modes), since both the register and the data are fixed 
at the time of writing a program. The equivalent BASIC instruction 
would be 
UT A= 5 

Obviously we need this kind of instruction, but we couldn't write 
entire programs this way 


Immediate addressing is convenient but does not solve any major 
problems. 


But at least we're starting to get someplace: we 
now specify which number gets 1 


programmers can 
её onto which registers. 


* Register 


iéressing. 


We dealt with this mode briefly earlier. The general format is 
12 B 
(or other instructions) 


This techique only involves two Hands; in short, this ís passing 
information from one hand to another. 


The CPU vill allow information passing between any two hands except 
the d (which we should not think of as а hand at all. It is 
the "ПАС" register and does not store numbers in the normal 
sense). 


Register 


dress instructions only need one byte. 


Instructions of this type are not only short (One byte), they are 
faster as well. The time needed го execute them is the time taken 
for 4 clock pulses, or less than 1 microsecond on the Spectrum. 


There is a 'rule' in writing machine language programs that hand 
hand transactions (register to register transfers) shoulé always be 
used when possible to improve program efficiency in time and 
storage. 


* Register indirect addressing 


ш ber). А oF ша, (re) 
ш (MD. п 


This powerful type of instruction causes the transfer of data 
between che CPU and a memory location pointed со by the content 
опе of the 16-bit register pairs (Feet). 


Register indirect addressing is faster than ordinary indirect 
addressing, since the CPU need not fetch the address from memory. 


However, we must load the register originally, and so regist 
indirect addressing (+ only advantageous when the program uses the 
same or neighboring adéress many tines. 


Tor example, 10 NLySHAPE lend KL with start of 
shape баса 
шор 10 A, (u) iRetrieve а data 


INC кі. zone pointer along 
continue LOOP 
until shape finish 


+ Extended Addressing 


ш А, (m) oF їр (ид 


Now ме are looking at how to store апе restore information from а 
to your Hand ané Feet from memory. 


In, Extended addre 
CPU with 


ing, the instruction from the program supply the 
address specified by two bytes. 


ДЕ the transaction (s to and from the accumulator, 
transfer vill only affect the content of memory ге! 
two-byte integer. 

ТЕ transaction 18 to and from a register pair, both the contents of 
menory location referred to by the two-byte integer and the next 
memory location will be affected. 


information 
егей ко by the 


The format of this type of instruction ist 


byte 1 op-code 

byte 2 (possible additional op-code) 

byte 3 low order value of the 16-bits integer 
value 

byte à high order value of that integer value 


Now this 18 the vay the program can read the певогу into the us 
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registers. Again, it requires an absolute address; in other words, 
the resulting program using this type of addressing may not be 
relocatable except when the absolute address the instruction is 
referring to is relocatable. 


eg. SHAPE DB путуп,... shape data bi 


ш A\(SHAPE) lese first byte of shape 
їп accumulator 


+ Indexed addressing 


шот, СИ +) өс ш ахлу. 9), г 
(or other instructions) 


This type of transaction involves а Foot of the CPU, the IX or IY 
index register. 


‘The CPU adds the contents of the index register to the address 
supplied with the instruction ín order to find the effective 
adáre 


This is one of the instruction type in 280 that has 16-bit opcode. 
Another common 16-bit instruction type (в the Block Load 
instructions eg. ІШІК (Load increment and repeat). 


One typical usage of this type of addri 
perform Table operations. 


ing technique is to 


The Index Registers can be used as pointer to the start of a table 
of data. A displacement value is supplied in the instruction to 
determine the address of the desired entry of the table the program 
want to refer to. 


ев. ШУ 1х, TABLESTART rinttlalise pointer to 
ystart of table 
ш A, (x23) irefer to the third byte 
ifrom the start of the 
table 
The format of instructions of this type is: 
byte 1 (op-code) 
byte 2 (op-code) 
byte 3 а idisplacement integer d 


The number '4' is an à-bit number which has to be specified 
together with еһе instruction and can mot be a variable. 
ie. the range of addressing (а limited from -128 to 127 from the 


a 


address pointed to by the index register. 


Indexed addressing is slower because the CPU must perform an 
addition in order to obtain the effective acéress. Yet indexed 
addressing is much more flexible since the same instruction can 
handle all the elements in an array or table. 


SUMMARY: 


There are many ways that the CPU can fetch B-bit information or 
transfer it from 8-bit registers to memory: 


formation to and from memory. Ко other combinations are 


Immediate addressing 
Defining in the progran the number to be 
transferred to any register. 

Register addressing 
Fron any register to any other regii 

Register indirect addressing 
Either using BC or DE to specify the address, and 
А ко hold the number to be transferred. 
Or using HL to specify the address and defining 
the number in the program 

Extended addressing 
Specifying the address in the program and using А 
to hold the 8-bit number 

Indexed addressing 
Using IX or IY to specify rhe start of a table in 
memory, and amy register to hold the 8-bit number. 
The displacement from the start of the table must 
be specified in the program. 
The number to be transferred to memory can also be 
specified in the program if desired. 


addressing modes are the only modes of transferring 


Instructions For One-ilanded Loading Operations 


Mnemonic Bytes Tine Effect оп 

Taken C Z PY 
LD Register, Register 1 4 aue 
ID Register, Number 2 7 Те? 
1D A, (Address) 3 13 “әл 
Up (Address), А 3 n а 
LD Register, (HL) 1 1 ша 
WA, (вс) 1 7 Ca S 
Ш А, (DE) 1 1 TD ж 
LD (HL), Register 1 7 Е 
10 (3C), А 1 1 B e 
ip (0E), А 1 7 pcs 
LD Register, (IX + d) 3 19 oes 
ID Register, (IY + d) 3 19 жес 
їр (IX + d), Register 3 19 => = 
Vp (IY + d), Register 3 19 свих 
LD (HL), Number 2 10 зле os 
LD (IX ^ d),mumber 4 19 ates 
LD (Y + dmumer & 19 E 


Flags notation: 


# indicates flag ís altered by operation 
0 indicates flag is set to O 

1 indicates flag is set to 1 

= indicates flag is unaffected 


Counting off Numbers on One Hand 


Since everything in the Spectrum CPU is designed around 8-bit hands 
or B-bit memory locations, it is obviously of major importance to 
learn how to count off numbers on one's hands. 


We discussed in the previous chapter some of the ways че can 
tansfer information from hand to hand. We will now deal with each one 
of these methods In more detail. You may recall опе as being called 
register adáressing. 


Аз we said, that ís just а big папе for saying transfer information 
from one register to another. 
Examples are: 
ша 
ша 
and so on. 


Remenber the terminology involved: "LD" means 
"with", and the mnemonic (abbreviation) instruction is 
same order as an english sentence. 


We would thus read out loud something like: 
ША 
"Load А vith BY. The next example would be read as 


We can swap from one hand to any other hand as ме mentioned 
earlier. Apart from one exception (the Flags register, which de not 
like the other registers), you can manipulate amy hand to any other 
hand. Even the seemingly stupid instruction "LD A, A" is 
permitted 


А short shorthand of this {s "LD r,r" where "r" represents any 


OK: № now know ve can shuffle information between ham 
that's mot going to do us much good without some original 
information on those hands. 


The second way that we can count off numbers on our hands [e for us 
to specify how many we want the CPU to count off on which hand! 


For example, count off 215 on hand "D. 1 am sure you know enough 
about the mnemonics by пом to be able to write this as: 


шо, 07 
(07 is the hexadecimal representation of 215). 


You may recall this was called immediate addressing. (Pretty 


obvious, isn't 167). 


Once again you cam do this with any of the registers, with any 
mumbers whatsoever. The limitation being of course the size of the 
number you can specify with В bits: 0 - 255. 


A short shorthand of this is "LD гуп" where "г" indicates апу 
register and "m" any number. The previous convention of one letter 
implies 8-bits still applies. 


Мом we're starting to get someplace: we can now specify which 
numbers get loaded onto which registers and we can өріп them around 
from hand to hand. But we still haven't learnt how to put any of 
these numbers away into menory locations, and there are only so 
many registers! 


We showed you very briefly an example of "extern: 
ме мете doing the time difference exerci, 
LD А, (Box #3) 


addressing” when 


The general mnemonic for this ins 
ША, (nn) 


Don't forget that in our shorthand the brackets imply "the contents 
ot". 


Note two things about this: 
1. You can only do it with Register A 

2. You have to supply the number of the box as a two handed 
(16-ЫЕ) number. 


The reve 
notice 


је instruction is also valid. This is one thing you will 
bout the 280 - there 14 symmetry about the instruction set: 
LD (on) ,A 


По notice that these instructions only apply го Register "А" 
there are of course other instructions for the other registers but 
mone quite as clear as this one, It's the dominant hand concept 
again. 


Let us pause here for a nanosecond and consider what these two 
imstructions actually mean and do for us. 


In the first place, the number range that can be defined by à two 
handed number (ап) is from 0 - 65,535. This is 64K, and means that 
the maximum memory that can be accessed by this instruction is only 
64K! This means that all the memory - ROM, program, display, and 
free memory - have to fit within 64%. On a "16К Spectrum" there is 
actually 16K used by the ROM and 16K of ВАМ making a total of Зак. 
The "16K" refers to the RAM part only. On the "АВК Spectrum", the 
same 16K of РОМ is present plus 48K of RAM making а total of 64K. 
ТЕ is no: possible therefore for the 280 to access more memory than 
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is available on a 48K Spectrum. 


The instruction "LD А, ап)" — which 18 read as "Load A with the 
contents of location nm" — is а very powerful instruction. le 
enables us to "read" the contents of any memory location, whether 
in ROM, or RAM. 


You can use this instruction to explore to your heart's desire, 
even to а location where there is no menory - ең to try to see what 
18 beyond the 32K memory even if you do not have additional memory. 
You will be surprised - it is not all zeros 


The reverse instruction "LD (nn),A" - which is ге "Load the 
contents of memory location on with A" - will attempt to write to 
amy memory location as well, but will be restricted by the physical 
Limitations: 


You can't write to а location that can't store that information, 
such ая in non-existent menory beyond the size of your system. 


One of the limitations of this instruction is that we have ко know 
at the time of writing the program which memory location we wish to 
examine or write into. The abbreviation "nn" means a definite 
number - eg. 17100 — and mot a variable. 


You can't use this instruction in the machine language equiv 

of a "Por - Next" loop. The main use for this instruction is 

therefore for setting aside particular memory locations as variable 

sto 

ең» define 32000 = speed 
32001 = height 
32002 = fuel left 

In a lunar lander type progr: 


lent 


You could therefore olan a 


rogram where you got the fuel left, 
dee! 


бей it, and stored the new amount of fuel back into that 
location, You vill know at the time of writing your program the 
address of that memory location which serves to act as а stroehouse 
for that information. 


Let us be clear about this. Location 32002 is not a variable. It 
is only a memory location which you use to store information. 


When writing your 
write something like 

LD A, (Fuel) 
and when you or the assembler program got to specifying the actual 
machine code for this instruction you would replace "fuel" by the 
hexadecimal address of the memory location you specified. 


enbly Language program you would therefore 


But what if ме don't know the exact address of the memory location 
where the information we seek 167 Suppose ме can only calculate 


where that information is going to be? Because ме need l6-bits to 
specify the address of any memory location, ve would need to store 
it im а lé-bit register: this means one of the register pairs ВС, 
DE, or SL, or one of the index registers IX or IY. 


Опе way we сап do this 18 to have one of the register pair contain 
the address of the memory location. Because the register contains 
the information and because ме don't have the address directly ve 
call this form of addressing register indirect addressing. 


The mnenonic abbreviations for these are 
ш г.Ош) 
LD A, (BC) 
їр A, (DE) 


The English reading of these instructions is 
“Load the register with the contents of the memory 
location pointed to by NL" 
"Load А with the contents of the memory location 
pointed to by BC" 
"Load А with the contents of the memory location 
pointed to by Di 


Note that by using "HL" as the pointer to our memory location ме 
сап load to any register - even Н or L, as strange as that may 
sound ~ but that using BC or DE we can only load into the A 
register. 


This is because the ML register pair is the favoured register pair 
in the same мау that the A register is the favoured single 
register. 


Once again there is а symmetry to these instructions and we can 
Store information into memory locations in à similar ма 
ш ut). 
iD (ВОЈА 
LD s). 


This is still called "Register indirect addressing" whichever 
direction the information flows in. 


Alternatively ме could use the index registers IX and IY to point 
to the memory location. 
The short shorthand of these instructions is: 


10 . (ir + 9) 
LD г.у . 4) 


те" is again any register, and "d" is the "displacement" 
from the address pointed to by ІХ or IY. (Don't get the use of "d" 
confused - we don't mean register "D" but d = displ 


севепс) 


The musber "d" is а one handed number (8-bit number) which has to 
be specified at the time of programming and cannot be a variable. 
This is the weakness of this particular instruction and means that 
its use is usually limited to reading and writing tables containing 
data. 


The symmetrical instruction is also available: 
10 (IX dsr 
LD (IY + dir 


1f this particular mode of adéressing sounds a little complicated, 
don't worry: you are unlikely to need it in your first few 
programs. 


The 280 chip used in the Sinclair computers is nothing Lf not 
versatile, and you can conbine some of the ways of loading numbers 
we described above- 


For example, you can combine immediate addressing (ie. specifying 
the number you want loaded) with external addressing Cie. 
specifying the address to be loaded by using а register pair). 


This is called - surprise, surprise - "Immediate Exteri 
Addressing". 


n 


Unfortunately you can only use the WL register pair and the short 
shorthand {s therefore: 


10 (ML) n 


This is useful as you can directly F111 a memory location without 
first having to load that value ín a register. 


A similar combination is possible with the index registers, called 
"Immediate Indexed Addressing: 


This is of more limited use, and the abbreviated form Гог th 
instructions are: 


ш (IX + d), 
LD (1Y + d); 


Using These Instructions in а Machine Language Program 


Let's try to put sone of these "LD" instructions into practice. 


We know from the previous chapters that after returning from а 
"USR' machine language program the value of the 'UST' is the 
contents of ВС. Let's run the following progr: 


(Load and RUN the EZ Code Machine Language Editor first, and set 
the Loading address to 32000) 

1 Oe 00 

2 e 


Now use the DUMP command to place this code into memory. 


From now on, ме will по longer be giving you such explicit 
instructions on loading and running machine language programs, 
dt is a cumbersome method and does not give you any additional 
understanding into the point of the program. 


We will assume that by now you have enough familiarity with the 

BASIC "EZ Code Machine Language Editor" and with the tables at the 
back of this book to be able to enter a program. We will therefore 
be showing all of our programs as follow 


or o0 ш c. o 
с RET 


This notation gives you the machine code on the left side and the 
280 assembly mnemonics in the right hand column. It also incicates 
very clearly which instructions require only a single byte (such as. 
RETurn) and which instructions require 2 bytes, etc. (you will 
remember that some instructions on the 280 can take up to 4 bytes!) 


The other point is that ve shall try to make all our programs 
independent of origin (where the program starts in memory) so that 
it does not matter what you specify as your loading address. 


Nonetheless remember that these programs can be entered with the 
VEZ Собе Machine Language Editor" program at the back of the book 
or any other loading program you may design yourself. 


Before running this machine Language program (you must "dump" the 
code into memory and then use the "run" command in the EZ Code 
program) what would you expect the result to be? 


The program sets the "c" register in the register pair ВС to zero, 
amd you know that BC starts off with the address of the progran, 
which is 32,000. 


Will be answer be А. 9900 
32000 
C. 31896 


Now run the program. Was the answer what you expected it to be? 


If you are unclear about why the answer was what it vas, go back 
and reread the chapter on "The Way Computers Count". 


Now try running che following program: 


06 00 ш во 
Ф 00 ш со 
с RET 


This will give you the expected result of 0 as BC = 0 (both 
registers B and C have been set to 0). 


You might like to try а few fancy tricks, such as loading А with a 
number, transferring to L, setting Н to 0, and so on. 


Exercise: 
The attribute file starts at address 5800Н. Ме сап set HL to point 
to the attribute File by the following program: 

26 58 1р н, 58H 

2z 00 ш по 


This means that you can now change the colours {n the display by 
using the LD (HL),n command. 


The structure of the attribute file is described in the Spect 
manual. Let us set the first character to ink red, paper white, 
flash on, This is 
10111010 = Вн 
во the next Line of the program will read 
36 ва lp (WL), BAI 


Now you must never forget to return from the machine language 
program, so the last line must be 
es RET 


RUN this machine language program. Did it work? 
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Flags and Their Uses. 


Flags are those nice buntings you can wave on state 
occasions. - wrong! 


Та machine language, the мога "flag" implies "indicator". A flag 
is something you put up If you wish to indicate to someone else 
that a certain condition exists. 


The obvious parallel is in boating where you run up a flag to 
indicate distress, country, piracy or whatever. 


The reason the designers of the 280 (and most CPU designers) use 
flags in their machine language 15 to give the programe: 
information about the status of the number in the CPU's dominant 
hand (the "А" register) or information about the last calculation 
Just performed. 


You will remember that one of the CPU's registers is dedicated to 
be а flags register - the 'P' register. You may also have noticed 
at the start of the last chapter a tal 

instructions to be discussed in that chapter, and that 
table was devoted to the effect each instruction would have on the 
flags. (Fortunately none of the instructions discussed in the last 
chapter affected any of the flags.) 


The flag vhose functioning is d is the Zero 


Flag. 


siest to underst 


This flag will be run up the flag-pole if the contents of the 'A' 
register is zero. 


There are many important decisions which will depend on whether 'A' 
is zero. Note that the zero flag is either on or off. You can't 
have an in-between result (shades of ‘a little pregnant') so that 
you would only need one bit to define the zero flag. 


Тһе same is true for all the other flags as well. They are either 
өп ог off and require only one bit. 


The Different Kinds Of Flags 


The "F" register is a regular 8-bit register and could therefore 
accommodate 8 different flags. In practice however the designers 
could only think of 6 flags! 


ам 2 (қу 


кабату fl 


. 
Parity Flag | 
Overflow flag | 
Subtract Flag 


ey 
flag) 


Actually the designers thought of seven Flags, but decided that one 
register could serve as both flags: the parity/overflow flag. 


Let us now look at each of these Flags in detall: 


Zero Flag, 


This is the flag we have already discussed above. Its application 
{з obvious, an the flag is usually set after an arithmetic 
operation as it serves to {néicate che contents of the ТА 
register. 


Hote carefully however that it is possible to have the 'A* register 
contain 0 amd for the zero flag not be set. This could easily 
happen by using the 


iD A 

Instruction. Ме mentioned above that none of the one-handet (8-bit) 
load instructions have апу effect on any of the flags. The zero 
flag would NOT be set yet A would contain zero. 


The zero flag is also set if the result of the "rotate ané shift" 
grow) of instructions results in а zero. 


As well, the zero flag is the only visible result of some resting 
instructions, such as the "bit testing" group of instructions. In 
thowe cases the zero flag is put om if the dit tested is zero 


Sign Flag: 


The sign flag is very similar to the zero flag and operates on very 
much the same sec of instructions (with the major point of 
departure being the "bit testing" group where the concept of a 


negative bit is somewhat meaningless in any case). 


Carry Flag 


This is one of the more important flags available tn 
Language, for without it the results of assembly lang 
arithmetic woulé be totally meaningles 


The point to remember а that 
refer to eith 


enbly language instructions alvays 
one-handed (8-bit) or two-handed (16-bit) numbers. 


This means that the numbers we are dealing with сап be either: 


0 - 255 
==) 09-65% 


Include carry, 


- 0-256 
=) 59-65% 


Consider the situation where we carry out the following subtraction 


200 
- м 


ule = 255! 


This i» а direct consequence of only having a Limited number range 
available, an the same thing can obviously happen with 16-bit 
numbers 


We've already discussed that you can only count to 255 on one һа 
What happens if a register is already showing 255 and you add 17 
You might like to think of the register as operating the same way 
of your car. Once you have reached the 
maximum, it ‘clocks’ over and begins counting from zero again. 


Та the same мау, if the register or car peter shows all zeros, and 
you turn it backwards, you will get the highest value shoving, or 
255 on an S-bit register. 


This 18 why the result of 200 - 201 gives 255. ТЕ ve меге car 
dealers we would obviously like an indication that the meter has 
clocked over, whether in a forward direction - in vhich case the 
car has travelled further than it seems - or a backwards direction 
= im which case the meter has been tampered with. 


This kind of indicator exists in machine language programming and 
is called the carry flag. Fortunately we do not need to worry about 
registers being tampered with. 


We have seen chat the carry flag can be set by subtractions if 
there is an ‘underflow’. The carry flag can also be set by addition 
operations if there should be an ‘overflow’. 


lt is therefore convenient to think of the carry bit as the 9th bit 
of the ‘A’ register: 
Number Carey bit Number in bit form 


122 = 
mt 3 


267 1 


But as ve do mot have 9 bits, the "А! register would contain the 
number СВЕ (Decimal 11) and the carry would be on (fe. = I). 


You сап see that on subtraction borrowing from а 9th bir would 
leave a '1' there as well. 


Using Flags in the 


Machine Language Equival 


In BASIC ме have the ability to construct 'IF ... THEN" situations 
such ав 


1f А0 then. . . 

what follows can be "Let..." 
or "Goto..." 
or ‘Gosub..! 


vhe 


Exact 
langua 


the same kind of decision can be programmed in machine 
(except for the er.. ), Instead of saying "If AsO", ме 
ely look at the zero Пав: if it is on, then ме know А-0. 


The three flags we have been considering to date are ín the main 
the only ones which allow us to make a choice in the next 
instruction to be executed. 


The format of such instruction is as follows: 
For example: 
JP сс, End 
where ‘JP! is the mnemonic for 'jump' and 'end' is a convenient 
label. 


The instruction is read in English 


"jump on condition cc to 
End". 


The condition “ес” could be any of: 
= Tero) 

Not zero) 

Positive) 

Minus) 

Carry set) 

Мо carry) 


The other three flags tend not to be of so much use ín every ау 
programming. They are: 


Partty/Overflow Flag: 


This flag acts as the parity flag for some instructions, and as the 
overflow flag on others, but there is rarely апу confusion as the 
two types of operations do not commonly occur together. 


The parity sice of it comes into effect during logical operations 
and 15 ser if there is an even number of set bits in the result. 
We deal with this in greater detail in the chapter on logical 
operations. 


The overflow i» a warning device that tells you that the arithmetic 
operation you have Just performed may not fit into the 2-bits. 
Mather than actually telling you that the result needed a Sth bit, 
this tells you that the sch bit changed a a result of the 
operation! 


In the exauple above, adding 132 and 135, the Већ bit was 'l* prior 
to the addition апе "0" afterwards, so chat the overflow would have 
been set. But the overflow would also be set by adding: 


Subtraction Flag: 


This flag is set if the last operation vas a subtraction? 


Ralf-Carry Flag: 


This flag is set in а manner similar со the carry flag but only in 
the case of an overflow or borrow from the Sth bit instead of from 
the 9th bit! 


Both the subtract flag and the half-carry flag are of use only in 
inary coded decimal” arithmetic, апе we deal with these flags in 
the chapter on "BCD Arithmetic". 


E 


Flags are used by the CPU to indicate certain conditions after 


There are six such Flags, each of which can be sald to be 
OFF. The зік bits representing these flags 
bits in the F register. The other two bits 


The conditions indicated by the various flags are 
Parity or Overflow 
Sign 
Negate 
Half Carry 


Not all instructions affect wach flag. Some affect all flags, som 


only specific flags, while others have no effect on the flags. 


Counting Up and Down 


Im the last chapter we examined the concept of flags, and in the 
chapter before we found out how the CPU is able to loaé any desired 
musbers onto ics fingers and toes. 


Let us now examine the simplest possible way to manipulate numbers 
оп one's fingers: we can increase the number represented on our 
fingers or ме can decrease the number represented. 


This is pretty rudimentary arithmetic, but it gets beyond loading 
speciffe numbers onto your fingers. The action of counting up is 
essentially: whatever number you have on your fingers, incre: 

by one. 


it 


This can be used in such ordinary situations as census taking or 
monitoring the traffic at a particular intersection. 


Counting Up: 


It is possible on the 280 to increase the count on the fingers of 
every single hand the CPU has. This is what we mean by the genera 
mnemonic 


се 


INC" ie read їп English as "incr 
1£-explanatory. 


and is therefore fairly 


те is also possible to increase the count held on the toes of any 
of the feet (including the register pairs, which are mot really 
feet, as ме вам). 


This increasing of the count on our toes is written 


INC rr 
Inc 1х 
100 tY 
where "re" denotes а register pair, such as "ВС", "DE", ог ни. 


Note again the sisple way ме have of denoting which operations are 
using B-bit numbers and which are 16-bit number 


The B-bit numbers are denoted by a single letter, while 
The 16-bit numbers are denoted by two letters. 


But the "counting up" instruction is in fact even more powerful 
than this might indicate. It is possible со increase the count of 
amy menory location if we are able to specify its adéress using the 


index registers or the 'favoured register pair’, WL: 
INC (1х + d) 
INC (ту + d) 
тис (ны) 


бөеге 


is the displacement - not the register D!) 


Important mot. 


Remember carefully our convention of reading brackets: 


bracki mean "contents of? 


This is very important 
instructions. 
INC ML 
INC (ML) 
bot а world of diffe 


there is а lot of similarity between the 


се in their execution. 


Th increase HL" while the 
read as је the contents of the locat‘on whos: 
i", (Chis second reading is often abbreviated to 
contents of HL"). 


first would be read a 


сопа would be 
address is 


As long аз you remenber the rules of the moenonic 
МИП be saved from this kind of confusion. Let us examine how each 
‚ and let's assume that HL = 58001. 


Look at HL. Increase the count on its fingers 
by one. Result: 
нь = 5в01н 


INC (HL): Look at HL. Find the memory location referred to by 
this number. Increase the count in that location by one. Result: 


на. = 58008 
($8004) = (56004) + 1 


These are significantly different operations. (You might like to 
RUN both versions - 56001 is the start of the attribute file). Note 
also that while "ОНС HL' is am instruction acting on a 16-bit 
number, "196 СИД" is am instruction which acts on an 8-bit number 
only - the geber stored in location 5800H! 


Decreasing the Count 


The symmetrical nature of the 280 instruction set would almost 
certainly ensure that everything you can increase you can also 
decrease, an this is indeed the cas 


DEC = 
DEC er 

DEC IX 

DEC ТУ 

DEC (HL) 
тес (1X + d) 
DEC (1Y + d) 


The mnenonic "DEC" is read in english as "decrease", and the same 
careful attention to the use of brackets must be applied here. 


Effect on Flags: 


Because the increase or decrease instructions which operate on 
B-bit numbers affect every flag except the carry flag, this is à 
very good place to review the operation of the fla 


IMPORTANT NOTE: the increase а instructions which 
operate on 16-byte numbers do NOT affect any of the flags. Only 
increase or decrease operations on 8-bit numbers affect the flags. 


Sign: This flag will be set («1) if bit 7 of the &-bit 
—— result is 1. 
This means it vill be on if the thumb is up using 
Gur previous analogy. Note that this will happen 
whichever convention you are using for the number. 


Zero: This flag will be 
zero. 


t (al) 16 the 8-bit result is 


Overflow: This flag will be set (=1) if the contem 
- bit 7 of the B-bic number is changed by the 
operation. 


Walf-Carry: This flag will be set (=1) 4f there is a carry 
into or a borrow from bit 4 of the В-Ы 


ds set 16 the last instruction was a 
subtraction, Thus it is not set («0) for "INC 
and set (<1) for "DEC". 


Use the "LD", "INC" and "DEC" group of instructions to rez 
numbers you want as a result of the 'USR' operation. 


This will give you familiarity with these instructions. 


SUMMARY: 


«аве or decrease the contents in any of the 8-bit 
registers or in any of the 16-bit register pairs or in either of 
the 16-bit indexing registers. 


We can also increase or decrease the contents of memory locations 
whose address is specified by the HL register pair or by the 
mdexing registers. 


increasing or decreasing 16-bit numbers will not affect any of the 
flags. Increasing or decreasing P-bit numbers, either in registers 
or in memory, affect all the flags except the carry flag. 


в? 


Instructions for One-Handed Arithmetical Onerations 


Mnenonic Bytes Tine 
ken c 


ADD А, register 
ADD А, number 
ADD A, (HL) 
ADD A, (IX + d) 
ADD A, (IY + d) 


ADC A, register 
ADC A, nunber 
ADC A, (HL) 
ADC A, CIX + d) 
ADC A, (IY + 4) 


SUB register 
SUB number 
SUB (HL) 
SUB (IX + D) 
SUB (IY + D) 


SBC А, register 
SBC А, number 
SBC А, GIL) 
SBC л, (1х + 4) 
SBC А, (IX + 4% 


СР register 
CP number 
cP (RL) 

CP (1Х + d 
[202 


—— —rf AL 


Flags Кога ова 


indicates flag is altered by operation 
indicates flag 15 set to 0 

indicates flag is set to 1 

indicates fl. unaffected 


2 


——— neras 


"———— 


ту 


——— эмаль 


ansan 


Effect on FL 


anasa нежен 


—— 


ооооо ососо 


— 


—— sarau 


One Handed Arithmetic 


One handed arithmetic is Just our reminder that all of these 
operations in this chapter involve only 8-bits and all of them must 
be carried out through our dominant hand, register A. 


1t seems that only our dominant hand knows how со add or subtrac 


This fact is so ingrained in the 280 machine language mnemonics 
that the abbreviation "А" 16 even omitted (а some mnemonics. For 
example to subtract “В! from "А", we would normally expect to see 
SUB A,B 
but in fact the mnemonic is 
ЕТІ 


Despite this limitation on arithmetical instructions (being 
restricted to the A register), the 280 language is very versatile 
їп what ме can actually add to whatever number ме have on our 


Add any single register to А 
Add any 8-bit number to A 

bit number in the box whose 
is given by NL 
S-bit number in the box whose 
is given by IX + d 
lt number in the box whose 
address is given by 1Y + d 


ADD A, (IX + 4) 


ADD А, (ir + d) 


You can appreciate the extremely versatile range of possible 
numbers ме can add to whatever number [s stored in A - any number, 
апу register and virtually any мау we care to define a memory 
location. 


The one that is missing is 
ADD A, (nn) 
where we define the address in the course of the program. 


As a result the only vay to get such an instruction would be to 
writ 


LD ul. oo 
ADD A, (HL) 


Note also the favoured role of the HL register again. Ve cannot 
specify the memory location using the BC or DC register pairs. 


The other limitation implicit im all this is also the inherent 
limitation of 8-bit numbers which can only hold values up to 255, 
ав ме have already seen. 


For example, LD 4. 80h 


ADD A, eln 


will give a result of only 1 in "А" but the carry flag will be set 
to indicate the result did not fit in. 


If the hexadecimal arithmetic confuses you, it's a good exerci 
convert the numbers to decimal and check the addition. 


Hexadecimal addition and subtraction is the same 
arithmetic: 


ordinary 
1-2 
2-3 

u get to 149 you 


9-4 
A=B 

ры get to ler you get 

P= 10 

This is because the ‘carry’ into the next column happens when you 


iet а number bigger than 'F' instead of '9' as in decima 
arithmetic. 


The results of our machine language program above would therefore 
be as follows: 


son 
dein as 8+ 8 le — LOH 


What can you do about this carry error?: 


The designers of the 280 have provided us with another instruction 
similar to ADD, but which takes into account possible overflows 
into the Carry. 


This is a very useful instruction: "ADC", which ме re 
WITH CARRY". 


4 as "ADD 


This is exactly the same as the "ADD" instruction, with the same 
range of numbers, registers, etc., which can be added to Register 
‘AY, except that the carry is added on (if it is set). 


This makes it possible to add numbers greater than 255 together, by 
з chaining operation: 


eg. to add 1000 (ie. O3EBH) со 2000 (ie. 07008) and store the 
result in 


їр A,EBH slower part of Ist mo. 
ADD A, DOH Lower part of 2nd no. 
LD c. iStore result in С 


т 


їр A,03H sigher part of Ist mo. 
ADC A,O7H Sligher part of 2nd no. 
LD B.A соге result in B 


After the first addition (ЕЁ + DO) we will have the carry set 
(because result was greater than FF) and Register А containing BB 
(check this for yourselves!) 


The second addition (3 + 7) will yield not OAM (= 10 decimal) as 
might seem on the surface but OBN (=11 decimal) because of the 
carry: 


The Final result is therefore ОВВАН = 3000! This chaining could go 
оп to take care of any size number, and the result stored in memory 
rather than in a register pair. 


B-BIT SUBTRACTION: 


This is exactly the same 
exist, one for or 
carry: 


B-bit addition, Two sets of commands 
mary subtraction, and one for subtraction with 


SUB в - Subtract в 
SBC - Subtract в with carry 


The notation "а! is meant to denote the same range of ро 
operands as for the ада instruction. 


ible 


n 


COMPARING TUO 8-БІТ NUMBERS: 


exactly what it is we mean when we compare смо numbers: 


We know what happens when the two numbers being compared are the 
same - they are ‘equal’. One way to denote this in an arithmetical 
format would be to say that the difference between the two numbers 


What if the number being compared is greater than the firs: number 
(comparison does imply relating two numbers: ме compare a number 
with what we already have on our fingers)? Then the result after 
subtracting the new number would be negative. 


Similarly if the new number is smaller, then the difference vould 
be positive. 


We can use these concepts to devise a system of comparisons in 
machine language. All ме need are the flags and the subtract 
operation. Suppose we wish to compare a range of nunbers with 5, 


LD А,5 iHumber ve have 
sub н iNumber being compared 
Then ме will have the following results — 
IEN = 5 Zero flag set, carry flag not set 
11 1 65 Zero flag not set, carry то: set 


ipa 5 Zero flag mot set, carry flag set 


ТЕ is therefore clear that the test for equality will be the zero 
flag, and the test for "greater than" will be the carry Пар, (The 
test for "less than" is the absence of oth Flags). 


The only inconvenience of this method is that the contents of "А" 
have been altered by the operation. 


Fortunately ме have the "CP s" operation. This is read in English 

“compare”. Note that it can only conpare what we already have 
їп the ЗА" register; the range of possible numbers to be compared 
are the same as for addition. 


"Compare" is exactly the sane 
contenta of 
flags. 


subtract" except that the 
А" are unchanged. Тһе only effect is therefore on the 


Eight-bit arithmetic on the 280 is limited to 
~ addition 
= subtraction 
- comparison 
and can only be performed through the A register. 


Given this Limitation 
exist. 


however, a wide range of addressing modes 


Because of the inherent nature of 8-bit numbers, we must always be 
careful about overflow. The carry flag (as well as all other flags) 

affected by arithmetical operations. Ме can use this as a 
warning of overflow. 


Additional instructions (add with carry and subtract with carry) 
allow us to chain arithmetical operations to deal with overflow. 


Instructions for Logical Operators 


Mnemonic Bytes Time Effect on Flags 

Taken с 2 PV S NW 
AND Register 1 4 ов вот 
AND Number 2 7 ове 01 
AND (HL) 1 7 о. £01 
AND (1х + d) 3 19 off £01 
AND (IY + d) 3 19 ое вот 
OR Register 1 4 ов. 400 
OR Number 2 7 ове жоо 
ок (HL) 1 1 ок. $00 
OR (IX + d) 3 19 oft #00 
ов (ir + 4) 3 19 ov жоо 
XOR Register 1 “ они 400 
XOR Number 2 1 ове FOO 
хов (HL) 1 1 off #00 
хов (IX + d) 3 19 ове гоо 
хов (Y + d) $ 19 off воо 


Flages Notation: 


altered by operation 
set to 0 

t tod 
unaffecte 


Ll 


Logical Operators. 


There are three operations which are as valuable in the field of 
machine (or assembly) language programming as the more commonly 
used addition, subtraction, multiplication or division are in 
ordinary arithmetic. 


These are generally referred to as Boolean operators after the man 
who formulated the rules of these operations. These operations are: 


AND. 
OR 
хов 


We are already familiar with the concept of operations which apply 
to an entire 8-bit number, but the reason that these operations are 

е оп the individual bits of the number 
(or fingers of the CPU's hand). 


Let us look at one of these operations, 'AND': 


Bit A Bit в Result of Bit A 'AND* Bit B 
o o о 
1 o 0 
0 1 9 
1 1 1 


lt iw obvious that the result of ап "АМО" operation is to give us a 
"17 only АҒА and B both contained а '1'. 


In machine language, if you AND two numbers, the result is what you 
would get if you 'AND'ed each of the individual bits of the two 
number: 


You may be asking yourself - "What (в the point of such an 
operation?" 


Тһе 'AND' operation is extremely useful in that ít allows us to 
mask a byte во that it is altered to contain only certain bits: 


1f, for example, we wish to limit a particular variable to the 
range of O - 7 only, ме quite clearly wish to indicate that ve want 
only the bits O — 2 to contain information. (1f bit 3 contained 
information, the number would be at least 


es. 0000 o101 E 
= ) 
These bits must be '0'. 


If we therefore take a number whose value ме do not know and apply 


5 


the 'AND' operation with 17%, the result will be a number which 
lies in the range 0 - 7. 


в. oiro 105 

0000 7 =)Mask 

result of W 0000 212) in 
range 0-7 


Note that the 280 chip only allows for the 'AND' operation to take 
place with che 'A register. "А! can be 'AND'ed with әп B-bit. 
number, апу of the other 8-bit registers, with (NL), with (1558), 
or with (174). 


мо 7 Note that as only the “А! register 
AND E сап be acted on, ít need not be 
AND (HL) mentioned in the instruction. 


Тһе same range of possibilities and the restriction to Register А 
is true for the other Boolean operations, "ОВ" and "хо". 


The "Ой! operation is very similar in concept to the "АМО" 
operation: 

Bit A Bit B Bit A 'OR' Bit B 

o o 0 

0 1 1 

1 o 1 

1 1 1 


Te ds obvious that the result of an 'OR' of 
‘Lt Af either А or В contained а '1' 


ation is to give us a 


Again you may be asking what de the point of such ап operation. 


The "Ой! operation is» also extremely useful in that it allows us to 
set amy bits іп a number: if, for example, we wished го ensure 
that a number vas odd, then quite clearly ме have to set Bit 0. 
(The same result could be obtained by using the "век!" instruction). 


Ш — A,Number 
«1 этәке number 


а 


The above two limes would be a typical 


embly listing. 


The concept of "ХОН! - pronounced ‘exclusive ог! — ís also easy to 
understand but its actual use in programming is more limited. 


The result of 'XOR' is а '1' only if ome of A or B contains a 117. 


Та other words, the result is the same as for the "Ой" operation in 


all cases except when both А and В contain a "1". 


Bit А Bit A 'XOR* Bit B 
o o o 
1 o 1 
0 1 1 
т 1 o 


The last thing че most consider is the effect that these operations 


have on the flags. 

Zero Flag This flag vill be on (41) 16 the 
result is zero 

Sign Flag This flag will be on (=1) if bit 7 of 
result if set 

Carry Flag Flag will be off (o) after "ако" 
"О" "ХОК" ie. carry will be 
reset. 

Parity Flag. This Нар vill be on (=t) if there 

(Note that this is even no. of bits in the result 

flag also doubles 0110 1110-) OFF 


overflow flag) 0110 1010-) ON. 
Walf-Carey FL Both flags turn off (40) after 
“АМО” той 'XOR'. 

These flags are useful tE "вс" 
arithmetic is being used. 


Subtract Flag 


Use of Boolean Operations on Р! 


There is а 


кесігі case of the Boolean operators which is very 
је of the register А operating on itself. 
А is unchanged, carry flag cleared 
А is unchanged, carry flag cleared 
А is set to 0, carry flag cleared. 


‘These instructions are often popular because they require only one 
byte to do what might otherwise require two, such as LD 4,0. 


The carry flag often needs to be cleared - eg. as a matter of 
routine before using any of the arithmetic operations such as 
лос ‘Add with carry 
звс Subtract with carry. 
and this can easily be done by the instruction AND A without 
affecting the contents of any of the registers. 


SUMMARY: 


There are three logical operators which are useful in machine 
Language: 


AND 
ов 
хов 


These only operate оп 8-bit numbers and one of these numbers must 
be stored in the A register. The result of the operation ік 
returned in the А register. 


Note that the meaning of the AND operation in machine language is 
different to its meaning as а BASIC instruction. 


The logical operators examine the individual bits of the two 
numbers, and are therefore useful in masking numbers or setting 
individual bits. 


Coping with Two Handed Numbers. 


So far, we have been dealing only with one-handed (8-bit) numbers, 
but we have talked about the fact that the CPU can also handle 
two-handed (16-bit) numbers in some cases. 


One case we have alre 
"feet" have 16 
numbers. 


dy mentioned is the index registers. These 
oes" (16 bits), and can only handle 16-bit 


As well, we know that using two hands together, we can sometimes 
hold a 16-bit number. We called these hands that go together 
"register pairs". They аге BC, DE, and NL. 


The CPU deals with 16-bit numbers in much the same way that you or 
1 would deal with heavy objects: we need two hands, ме аге not very 
Pt at manipulating such objects, and the мау ме handle them is 

slow and limited. 


Let us now examine the various addressing modes (possible 
contortions?) available for dealing with 16-bit number: 


Immediate Extended addr 


Ang: 


Ш er, nn 
(or other instruction) 


This is the equivalent of 8-bit inmediate ааг; 


ing. lt is merely 


immediate addressing extended so as to accomodate 16-bit data 
transfer. 

As а general role instructions that operate on 16-bit numbers are 
longer and slower than those for 8-bits. For example, while B-bit 


immediate addressing instructions are 2 bytes long (one for the 
instruction and one for the number), the extended version - ie 
16-bit - r 


The format for Immediate Extended Addressing is as follows: 


Byte 1 Instruction 

Byte 2 al Low order byte of 
the number 

Byte 3 m Migh order byte of 


the number. 


We use this type of addressing instruction to define the contents 
of a register pair, for example a pointer to a memory location. 


Register addressing 


You may recall that register addressing is the name we give to an 
instruction if the value we want to manipulate is stored in one of 
the registers. 


The same holds true for 16-bit instructions, except that there are 
only a few instructions of this type in the CPU's repertoire. These 
are mainly relating to arithmetical operations, and extremely 
Limited in the register combinations allowed. 


eae ADD нь, вс 


We will mention here again the preference the CPU has for its HL 
register pair. This is where the muscle goes, and some instructions 
can only be carried out by this register pair. This is true of the 
arithmetical instructions, and we deal with this in detail in a 
later chapter. 


Register indirect addressinj 


Register indirect addressing is the name we give to instructions 
whore the value ve want is in memory, and the address of the memory 
location is held by a register patr. 


Та the 280, this су 
the register pair HL 


of addressing is again mainly applied using 


э (ul) 


img is similar in concept to register indirect 
iressing, except that the value you want is not held in 
а register pair, but in a pair of memory locations. 

E LD ML, (nn) 

where па must be specified at the program stage. 


Exercises: 


Using the EZ Code Machine Language Editor, enter the following 
programs: 


1. Immediate extended addressing: 


ororoo Lo 80,15 iload BC with value 15 
с RET ireturn 


is run, you will see that the value of USR on 
return from the machine language program is 15, just as ме defined 
и. 


Note how limited this type of addressing is: you must specify the 
value of the number in the program. 


2. Register addres 


We will now add а line to the program above: 


210040 10 HL, 4000H lead ML with 16384 


01000 10 в, 15 iload BC with 15 
09 ADD HL, BC зада the two numbers. 
с9 RET 'eturn 


1f you run this program, you will still get the 
above, namely 15! Why? Didn't ме add 163847 


The answer is that ме did, but it all happened in the NL register 
pair, so we didn't see any of it! To see what happened, ме 
add a few Ling 


3. Extended. 


226470 пр (треш) 
ED4B647D LD вс, (20648) 


ше HL in 32100 and 32101 
iget value of BC from 
132100 and 32101 


сә шт 


This method of transferring information from HL to BC would mot 
actually be used in programming, as the PUSH and POP instructions 
are more efficient, but it does illustrate what needs to be done 
at times to overcome the límited addressing modes of the 280 CPU. 


You can examine memory locations 32100 and 32101 using the "mem" 
command to check on this program as well. 


H 
i 


М 


Manipulating Numbers with Two Hands. 


In the earlier chapters we have seen just how agile the CPU can be 
im manipulating numbers on one hand, and we have just discussed the 
vay it can handle two-handed numbers. 


The CPU's mathematical ability (в such that he can perform very 
complex calculations involving large numbers with only one hand. 
Why then bother with two-handed numbers? 


There vill be times when you will find it is impossible to specify 
everything you vant with just B-bit numbers, If we were limited to 
just the range of O - 255 of the 8-bit numbers our computer would 
Indeed be a very Limited machin 


The most glaring example of needing 16-bit numbers is specifying 
the address of a memory location, We implied that such a 
manipulation would be possible when we discussed instructions such 
as LD A, (HL). 


‘The slow way of doing things would be to load each individual 
register in the register pair, as we did in previous exerci 


Fortunately for us there are some (but only a few) instructions on 
the 280 chip which allow us to manipulate 16-bit numbers. In this 
chapter ме shall be dealing with loading 16-bit numbers, while the 
next chapter will deal with 16-bit arithmetic. 


Specifying Addresses with 16-Bit Numbers: 


Please note that all 
number. 


dresses must be specifi 


by а 16-bit 


even if tt is 
> it's not an 


You just can't specify an addres only В-ы 
only from 0 to 255, the CPU wori 
address unless it is 2 bytes of В bits each. 


We implied this when we used the short shorthand of 
ш A, (nn) 
So also remember that l6-bits numbers are stored in register pairs 


high mumber first (check again with our chapter on "A Look into the 
CPU" . . . - "HL" stands for Н = "high"; L = "low 


Storing 16-Bit Numbers In Memory 


‘There is one facet of 280 design which is very difficult to explain 
or justify: 


Instructions For Two-Handed Loading Operations 


Mnemonic Bytes Time Effect on 


Taken C 2 PY 
Reg pair, Number / lo 
TX, Number 4 с 

ТҮ, Number 4 db ерата 


(Address), ВС or DE à 20 CO 


ББЕБ 5555 БББ 


Flags Notation: 


И cates flag is altered by operation 
O Indicates flag is set to 0 

1 flag is set to 1 

= is unaffected 


5 


When loading 16-bit numbers into memory, the reverse convention 
from that of register pairs is used. 


The low bit is always stored first in memory! 


Let us consider а situation where we place the contents of HL into 
menory: 


Before: Location Contents 
32000 00 

н L 32001 оо 

то о 32002 00 


Let us assume that HL contains the number 258 decimal = 01029. The 
memory locations are all empty. 


Afters Location Contents 
32000 02 

нь 32001 о 

ө ог 32002 [3 


The convention with 16-ЬНЕ numbers stored in memory (and in program 
listings) is that the Том bit is always stored First. 


There is no justification for that decision except to say that this 
was what the designers of the 280 came up with and we пом have to 
live with it. 


this carefully and make sure that you are 
familiar with this reversal of convention. 1t is likely to be the 
Single most important source of errors in programs: 


In registers: Wigh bit stored first 
In memory and programs: Low bit stored first 


lt is mot something that сап be glossed over and ignored as every 
time you deal with a 16-bit instruction in machine code you vill 
need to think carefully about the order of the Том and high bits 


Do not however feel put off by this - life on the 280 would be 
Virtually impossible without 16-bit instructions and it's а price 
we have со рау. 


You can check this for yourselves by "running" this instruction 
Using the "EZ Code Machine Language Editor and then examining the 
contents of memory using the "mem" command. 


Loading 16-Bit Numbers 


Тһе lé-bit load group at its simplest comprises of loading а 16-bit 
number іп the register pair. The general mnemonic abbreviation is 
1D er. an 


using the notation of 2 letters to indicate а 
т" means any register pair, "na" any 16-bit 


For those of you without the benefit of an assembler - that is if 
you have to convert the mnemonics into code Бу hand using the 
tables at the back of the book - then the discussion ve had on the 
order of the 16-bit numbers in memory becomes crucial. 


Even if you do have an assembler, you should be aware of 
reversals of order to enable you to "read" the code when 
into memory. 


hese 


Let us look at a specific example: 


Load WL with 258 
The mnemonic for this is 
LD . oon 


The instruction for ‘LD Hi,nn' is, as you will find at the end of 


that,the number 0102Ң needs to be inserted in place of 
Bot because of the reversal rule, ме do mot enter 


this as 10029. 


The proper instruction is therefore: 
21 02 01 
In our examples ме will show you this as 


210201 їр Mi, 0102H ( = 258) 
You may not have problems entering our programs, but you must be 


very familiar with this so that it is mot a problem when you write 
your own programs. 


Other 16-Bit Load Instructions 


As well as being able to load 16-bit numbers directly into the 
register pairs ме can also load 16-bit numbers directly into the 
index registers (which are both 16-гое feet, as you will remember). 


їр IX, an 
ш IY, an 


We сап also manipulate information between а register pair and two 
successive locations in memory. (This is the 16-bit equivalent of 
loading the information from a single register into a single menory 
location). 


The general instructions are 

LD (an), тг 

LD (nn), IX 

1D (ва); IY 
Remember that brackets are the shorthand for "contents of", so that 
the last instruction would be read as ‘load the contents of memory 
location nn with the value in register IY'. 


Because we are dealing with 16-bit numbers, we are actually 1 
the memory location specified and the following memory location 
into the register pair. It {з mot necessary to specify both 
addresses (because the CPU can figure out the address of the second 
location) but be careful mot to confuse 8-bit operations with 
16-bit operations. 


The reciprocal mature of many of the instructions e also apparent 
here, and we can also load a register pair or index register with 
whatever is in a specific pair of memory locations: 


їр rr, (nn) 
їр 1x, (nn) 
LD D, (nn) 


We know from the Spectrum manual that the start of spare space can 
be obtained by looking at the contents of memory locations 23653 
and 23654. 


In BASIC we can determine this by using the line 
PRINT PEEK 23653 + 256 + PEEK 23654 


We will now perform the same task using machine language: 
(23653 = 565) 


ED 4b 65 5 1 BC, (23653) 
c9 RET 


NOTE VERY CAREFULLY THAT THE NUMBERS ARE ENTERED LOW BYTE FIRST AND 
YOU WOULD GET A TOTALLY ERRONEOUS ANSWER ТР YOU WERE TO ENTER THEM 
THE OTHER WAY AROUND. 


On the Spectrum, ve know that once the program {5 finalised the. 
position of the spare memory is fixed and we only need to determine 


вт 


this once in each program. 


Ме use the BC register to get the information because, as you will 
recall, the value of USR 15 the contents of the BC register pair 
when the machine language program has finished. 


Note that "LD BC, (NN)" is a four-byte instruction! 


You can use similar programs to determine the value of amy of the 
two byte variables listed in the Spectrum manual on pages 173 - 
176. 


‘SUMMARY: 


We сап load 16-bit numbers into any of the register pairs or into 
the index registers either by specifying the 16-bit number or the 
memory location where the 16-bit number is to be found. 


Similarly ме can transfer into memory a 16-bit number from any of 
the register pairs of from the index registers. 


The only point to note very carefully is the peculiar order that 
lé-bit numbers are stored by the 280 CPU in memory (and therefore 
im program instructions involving 16-bit numbers): 

Тһе low byte is alvays stored first 111 


structions for Stack Operations 


Mnemonic Bytes Time Effect on flags 
Taken C Z M S NW 


PUSH Reg pair 1 и 47521142 
PUSH IX or IY 2 15 БА MN AE 
POP Reg pi 10 5 
POP IX or IY 2 n са aom 
LD SP, Address — 3 10 DC а 
LD SP, (Address) 3 20 бе дас 
Ш sP, Н 1 6 T през DNE 
LD SP, Ik оглу 2 10 EE 


Flags Notation 


# Indicates flag is altered by operation 
O Indicates flag is set to O 

1 Indicates flag is set to 1 

- Indicates flag ts unaffected 


Manipulating the Stack 


You may recall the image we developed in the beginning of the book 
of the stack as being where the CPU was able to keep information 
without having to remember the address of that particular 
information. 


One of the advantages, possibly inadvertent, of the stack 
operations is that we can only PUSH and POP information in two 
handed (16-bit) lots. This is because the stack is primarily 
designed to remember addresses and ме need to specify addresses as 
16-bit numbers. 


The 


meral instructions for pushing information to the stack аге 
PUSH rr 
PUSH 1х 
PUSH lY 


and the general instruction for popping information back from the 
stack are 

POP er 

POP IX 

vor 1Y 


These are exceptionally simple instructions, and you will note the 
lack of need to specify an addre: 


For the ordinary register р 


та - de. not the index registers — 
ingle byte long and therefore very 
economical in terms of programming space. 


PUSH instructions are also not destructive: that is, the 16-bit 
register still contains the same information after the PUSHes. 


Note that because ме can PUSH any register pair and POP апу 
register pair, the register you POP needs not be the same as the 
опе you PUSHed! 


For example 


төн вс 
POP HL. 


The effect of these смо instructions is to leave the contents of 
the BC register unchanged but set the HL register to whatever the 
contents of the BC register was at the time of the PUSH 
instruction. 


This effectively adás am instruction of the type 


LD rr, те" 
to the lé-bit load group which was conspicuously missing. 


As each of РОЗН and POP instruction for register pairs is only one 
byte long, the cost in terms of memory is not expensive. 


The other extra benefit is that we are able to PUSH or POP the 
register pair AF! This is one of the few instructions vhere АҒ 16 
treated as a register pair, but it is obviously sensible because 
there are many times when ve would like to preserve the contents of 
the flags. 


What this means is chat you can PUSH AF (in effect making а note of 
what A and Р are), perform calculations which may affect the fl 
as an undesirable side effect, and then POP back AF, leaving the 
flags unchanged. 


Moving the Stack Around: 


As you know, the real strength of the PUSH and POP instructions is 
that we do mot have to think about the addresses where the numbers 


are PUSHed to or POPed from. 
You will surely agree that it does not necessarily make sense that 
the same area of memory should serve as a stack whether you 


have 16K of memory ог whether you have 48K. 


The vay the CPU actually keeps track of the address of the stack . 
by means of a "stack pointer", which can be thought of as а 16-bit 
register. We mentioned this briefly in our discussion of 

but mot in апу of the LOAD, etc. instructions because it 
the 


The main thing one would want to do with the stack pointer is to 
fine its position in memory, and that is exactly the type of 
instruction that is available: 


їр SP, nn 
Ш SP, (пп) 
Ш SP, IX 
Ш sr. 1¥ 


You can examine the stack of the Spectrum by using the "mem" 
command of the "EZ Code Machine Language Editor" program, and 
looking in the last 30 - 40 bytes before RAMTO! 


Do not change the contents of the locations in the stack 


Almost any change will cause your Spectrum to crash - the screen 
Will go blank and you will have to turn the power on again. This 
is because the operating system places a lot of information it 


requires on the stack and changes will cause it to bomb out. 


For the same reason do mot try to manipulate the position of the 
stack pointer unless you are sure of what you are doing. 


Note: 
In a well organized program the number of POPs and PUSHes should 


end up the same по matter which path the program follows. Апу 
miscalculation may lead to strange results, 


Exercis 


We cam use these instructions to examine the address at which the 
USR subroutine is called from by 'POP'ing the value out of the 
stack amd into the return register BC, The following program shows 


а PoP вс t address in BC 
су РОЗН BC Рие it back on the stack 
сә жет 


Instructions for Two Handed Arithmetic 


Flags Notation: 


Indicates flag is 
Indicates flag is 
Indicates flag is 
Indicates flag is 
Indica 


—— — 


altered by operation 
set to 0 

set to 1 

unaffected 


effect is not known 


ee. а 


1, 
н 


6000900900 


Effect on Flags 
z му 


TwoFisted Arithmetic 


One of the benefits of being able to have 16-bit capabilities on 
what is effectively ап 8-bit processor is that we сап use the 
lé-bits to specify addresses, or to perform calculations involving 
integer numbers up to 65,355 (or in the range -32,768 to 432,767 if 
negative numbers are to be permitted). 


In this light it is easy to see why in some early microcomputers, 
like the oríginal Sinclair ZX80, all arithmetic in BASIC was 
limited to integer numbers in the range -32,000 to 432,000. 


Bot even though we can perform some arithmetic with two hands, ош 
title for this chapter gives а hint of what is to come - two handed 
arithmetic is a little clumsy compared to one-handed arithmetic. 
The range of options is just not there! 


Favoured Register 


In the same way that the 'A' г 
B-bit arithmetic, во there is 
arithmetic, and it is the HL register pair. 


ster is the favoured register in 


This favoritism is not quite so pronounced as in the В-Ы c 
we до not omit the name of the register pair. 


Addition: 


Тһе additions are quite straightforward: 
ADD HL, BC 
ADD ML,DE 
ADD мені. 
ADD WL,SP 


But that is de! 


Note that it is not possible to add an absolute mumber to ML - eg. 
"Add Мила is mot permitted. To perform that kind of calculation 
ме need to: 

LD pf. un 

ADD HL,DE 


When you consider that this now ties up four of the 8-Біс registers 
out of a total of 7, you realise it's not something you want to do 
too often. 


Note also that there is no addition betwen HL and the index 


registers. You will also remember that there is no LOAD 
instruction which permits you to transfer the contents of IX or IY 


to BC or DE, so the only чау to do such ап addition would be like: 


PUSH 1х 
POP DE 
ADD WL,DE 


The one point of note is the 'SP' register - the stack pointer. 
This is one of the very few operations where 'SP' is treated like а 
proper register, but obviously you can't use it as a variable! 
Think of what would happen to all the POPs and PUSHes if you varied 
the contents of 'SP' at wil 


Effect on Flags 


16-bit arithmetic is where the carry flag really comes into а field 
of its own, because as you can see from the table at the beginning 
of this chapter, the only other flag that 16 affected by the ‘add’ 
instruction is the ‘subtraction! flag (and all we are saying is 
that the "ада" instruction 1з not a subtraction!) 


The carry flag will be set íf there is an overflow from the high 
bit of 'H' ~ any overflow from 'L' is automatically placed into 'Н' 
by the calculation. 


Ада With Carry: 


Because of the Limited nature of 16-6108, we are able to chain 
additions just as in the B-bít case. The instruction "add with 
‘ADC! = operates in a similar manner to " 
range of register pates: 

. e 

ML,DE 

HL HL 

HLS 


16-Bit Subtraction 


16-bit subtraction is also a very straightforward operation, but 
there 48 no subtraction without carry: if you are not sure of the 
status of the carry flag, be sure that your program includes a line 
to clear the carry flag before any subtraction operation. 

sac ML,BC 


(That Last instruction has obvious application: set HL to the end 
of the memory used by your program, screen display and variables, 


ibtract SP, and the result (negative) will be the amount of free 
space. Can you write a simple program to do that? See the end of 
the chapter to confirm your solution). 


Effect Of Carry Arithmetic On Flags: 


You may have noticed that three other flags are affected by the 
"аба with carry and ‘subtract with carry’ that were not affected 
by the simple 16-bit addition instructions, 


These are the zero flag, the sign {lag and overflow flag. Each of 
these is set according to the result of the operation. 


Index Register Arithmetic 


Index registers are totally limited to addition without carry! 


Furthermore the range of registers that can be added to the index 
registers is extremely Limited: 


Adding the "ВС" or "DE" register pair 
Adding the index register to itself 
Adding the stack pointer. 


Solution to Memory Left Exercise: 


The end of the memory space the program uses (в defined by the 
contents of the STKEND memory location. This is defined as 23653 
and 23654 in the Spectrum manual. 


Obviously if ме Lo 
halfway there: 


HL with the contents of that location we are 


LD HL, (STREND) 
then subtract the "stack pointer! (SBC HL,SP 7) 


Because of the ‘carry! we need to clear the carry flag. This is 
most easily achieved by the "AND А" instruction, which is covered 
earlier in the book (р77). 

лю А 

5С f. sr 


‘Three-quarter marks if you knew you had to allow for the carry but 
didn't know how to do it. One-quarter marks if you forgot all 
about the carry. 


Because the stack pointer is in higher memory than the top of your 
program (or else you are in diabolical trouble) the result will be 
negative. 


Let us now proceed to get the number of bytes left as a positive 
musber, using the "ВС! register ('DE' would be just as good for 
this). We first vant to shift HL to BC, but there is по ‘load’ 
instruction to do this and ме will need to use a push followed by а 
pop: 

PUSH HL 

POP вс 


вс 


NL still has the same information as before, so Hi 


To get HL = -BC, subtract ВС from HL twice (but don't forget that 
the carry has just been set by the subtraction so must be cleared 
again: 


ANDA 
SBC н,вс 
SBC ML,BC 
НЕ now contains the negative value of what it contained before - 
ie. the positive number of bytes left. 


We now need to get the number back into the BC register pair again 
to get a result from the 'USR' function. To get ML back into BC. 
PUSH NL 
POP вс. 


and finally а return from the USR function: 
RET 


Did you get this right? 
Notice how handy the stack ia! 


Loops and Jumps 


Loops and jumps are what gives a computer program real power. Once 
you have the ability to make decisions and to execute different 
bits of programs as a result of previous calculations you are 
really getting places. 


This freedom can also cause problems, create programs vhich are 
difficult to follow, and almost impossible to debug. 


1 would strongly suggest that you design your computer programs 
carefully before writing any machine code, and that is why ме have 
included the chapter "Planning Your Machine Language Program". 1 
emphasise this now because loops and jumps are vhat will entice you 
away from good program design. 


Machine Language Equivalent of 'COTO': 


1n BASIC, you are familiar with the instruction 'COTO', which 
transfers control of your program to the instructions іп the line 
you "0070". 


Nothing could be simpler to implement in machine language: just 
specify the memory location vhere you would líke the CPU to fi 
the next instruction and you are half-way there. 


The most simple instruction is "Jump То": 
2р хх хх 
3e (ш) 
3» (00 
Р (Ту) 


One of these instructions сап also be made to be dependent on the 
status of ome of the flags, such as the carry flag. This 
conditional jump instruction is: 


JP cc, an 
where cc is the condition to be met. If we had 
JP 2,0000 


for example, this would be read "jump if zero flag is set to 
address 10000". (This is the address the Spectrum jumps to when 
you turn the power on, and as such a 'JP' to zero might be used іп 
а machine language program if you wanted to clear all the memory 
amd start again with 'К'). 


Now note that the CPU does not allow for any mistakes. If you say 
"МР", it will jump. Because almost апу code can be construed as 
an instruction, the CPU does not care if you land it in the middle 
of data, or in the second byte of a two-byte instruction: ít will 
read the byte at the address it finds and presumes that is the 


start of the веже instruction. 


The way the CPU works out the jump instructions is really quite 
simple: it has а little counter called the "program counter" which 
tells it where to find the next instruction to be executed. In the 
normal course of programming (that is, without jumps) the CPU looks 
at the instruction to be executed and adds however many bytes there 
are to the instruction to the program counter. 


Thus if it meets а 2-byte instruction, it adds 2, while a 4-byte 
instruction will make it add 4 to the program counter. 


When it comes across а "jump" instruction, it merely replaces the 


contents of the program counter with whatever value you have 
specified. That is why you cannot allow any errors to creep in. 
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Long Jumps and Short Jumps 


We cam describe the above instructions to be the machine language 
equivalent of a ‘long ішер! because the 16-bit address allows us to 
jump to anywhere the 280 chip can possibly go. 


The disadvantage of the long jump is that: 
А. Often ме don't want to jump that far but still 
have to use а 3-byte instruction. 
We cannot easily relocate the program to another 
part of memory because we are specifying 
the absolute address. 


1t was mainly to overcome these two disadvantages that the ‘short 
jump! was introduced. This is referred to as a "relative Jump" and 
allows us to jump мр to «127 bytes from our present position or up 
to -128 bytes from the present position. ie. the distance jumped 
can be specified in one byte! 


Relative Jump Instruction: 


ж а 
where d ls the relative displacement. 


We can also make the relative jump dependent on some condition, 
Such as whether the carry is set, or the zero flag is set, for 
example. These conditional Jumps are written a 

З cc, d 
where cc is the condition to be met. 


The value of the displacement '4' is added to the 
countes 


This means it takes the present value of the progi 
adds the relative value you have specified. The value you sj 
сап be either positive - jumping forward - or negative - jumping 
backwards. It you check back to our chapter on negative number: 
you will realise this means that relative jumps are limited to the 
range -128 to 4127. 


Note that, when the CPU is executing a relative jump instruction, 
the program counter is already pointing to the next instruction 
which would be executed if the condition was not met. 


‘This is because when the CPU comes across "JR" it knows that it has 
а 2-byte instruction to deal with and adds 2 to the program counter 
= the program counter is therefore pointing to the instruction 
after the relative jump! 


Eg. In а program such as 


лот 


Location Code 


32000 ADD A,B 
32001 JR 2,028 
32003 10 во 
32005 Next LD ML, 40000 


The following is the vay the CPU deals with the program if ic 
ignores the jump instruction at 32001 (ie. zero flag not set): 


Load byte at 32000 
Because the byte is only а l-byte instruction so set 
program counter to 32001. 

Execute instruction, 

Load byte specified by Program Counter (32001) 

Byte is part of 2-byte instruction so add 2 to 
Program Counter to make it 32003 

Get next byte to complete instruction 

Execute instruction 

'cified by Program Counter (32003) 

2-byte instruction so add 2 to 

(вом eaqual to 32005) 

Get next byte to complete instruction 

Execute Instruction 


At location 32001 the program encounters the Relative Jump 
instruction. 1f the zero flag de not set, as in our example above, 
the CPU does nothing. 


In general, the CPU executes jump instructions as follows: 


Ш the zero flag is set, add 2 more to the Program 
Counter (this would make it > 32005) 

Lf the zero flag ís not set, do nothing 
(Program Counter remains = 32003) 


1m other words, the relative jump allows us to jump over the 
instruction "LD B,O" in certain cases. 


This also explains why there are two times shown for the time taken 
for this instruction. It takes less time to do nothing than to 
calculate the new program counter. 


The CPU will therefore execute either the instruction at 32003 or 
the instruction at 32005 depending on the zero fl. 


ТЕ is also possible to make the relative Jump negative as ме have 
already mentioned. 


Exercise: 
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Because the relative jump is а 2-byte instruction, and the program 
counter is pointing to the next instruction after the relative 
jump, what would be the effect of an instruction which read: 


LOS 


Machine Language "For Next" Loop 


You are, 1 am sure, familiar with the BASIC form of the 
"Por... Next" loops: 


The machine language equivalent is similar but takes a different 
form. Let us consider how ve could implement the machine language 
loop using the arithmetic functions and the relative jump: 


jSet counter to 1 
Max. of counter + 1 
1 
sIncrement counter 

i ls B= a? 

JR NZ,LOOP 3 М not loop again 


This will work, but mote the following: 


We are tying up 2 register 
the maximum; and che instruction which increments the counter дон 
mot set any flags on completion. 


А much better way would be if ме counted down! 


We know that we have to do the loop 6 tim 
6 and count down! 
This will give us: 


so why not set ‘BY to 


ш ње iset counter 
шо, псе Cecel 
DEC в iDecrease counter 
JR NZ, LOOP jloop is not finished 


You can see that this is а much more efficient мау of doing things. 


The 280 chip has a special instruction which combine 
lines above. 


the last two 


This instruction is written 


элт 4 
and is read as "decrease (B) and jump if not zero". (Тһе d is the 
relative displacement). This instruction is a 2-byte instruction 
amd therefore saves one byte on the above coding. 


Because of the existence of this special instruction, the 
register is usually used as a counting register. 


The limitation of the 'DJNZ' instruction is that one сап only count 
up to 256. DJNZ instructions cam however be nested, if require 


їр p. on ele 
BIGLOO PUSH BC sSave value of 
15 5.0 iSet 5.256 


LATLOOP . 
iWhatever calculation 


DINZ LITLOOP | iDone 256 times? 


POP вс iGet back value of B 
ола iDo bigloop 16 times 


Try and write down on а piece of paper what would appear in each 
register after each instruction in the above program. 


Waiting Loops: 


There are times in machine language programs when thin 
fast it is necessary to Just wait a little while. 
Examples that spring со mind are sending information to а cassette 
(the pips have to be spaced sufficiently far apart to be able to 
read them later) or sending information to а typewríter (imagine 
printing thousands of characters a second). 


happen 


It is therefore useful to set up waiting loops using the DJNZ 
instruct ior 


LD B, Count 
WAIT орт WAIT 


The instruction 'DJNZ WAIT! will cause the CPU to jump back to the 
DINZ instruction as many times as required to set “В! back to zero 
before proceeding agaín. 


This should give you the answer to our exercise of мвас happens 
when you write 
WAIT JR чат 


You might be waiting quite awhile for the CPU to exit this loop! 


ы 


Instructions for Call and Return Group 


Mnemonic Bytes Time Effect on Flags 

Taken Сам S NW 
Call address 3 DIN E 
Call ccaddress 3 Тот ЕКА 
вт 1 W 
RET се 1 TU ЖУСА ДЫР 


Note: се (в condition to be met for instruction to be executed. 
The following are the conditions which can be used: 


Flag Abbreviation Meaning. 
carry c Garry Set (21) 
к Carry Clear (20) 
Zero 2 Zero бек (1) 
x Zero Clear (+0) 
Parity [3 Parity Even (51) 
Ро Parity Odd (0) 
Stan н Sign Minus (ot) 
P Sign Pos. (-0) 


Flags Effected: 


Note that none of the flags are effected by the call ог return 
instructions. 


Timing: 


Where two times are shown, the shorter time indicated is for the 
case of the condition not being met. 
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Use of Subroutines 


The use of subroutines is as easy in machine language programming 
аз it is in ordinary BASIC programs, if not easier. 


In fact, remember that using the "USR' function in your BASIC 
program із really calling a subroutine: you will recall we need to 
have a 'RETura! instruction to finish! 


Therefore it is very easy for you to test certain subroutines 
independently of your main machine language program. 


Тһе major difference that you vill face in implementing subroutines 
in your machine language program is that it 15 necessary for you to 
know the address where the subroutine starts. 


This can cause a problem if you stoi 
in а variable array, because the 
necessarily fixed. It also mea 
that use subroutines cannot 
memory. 


the machine language routines. 
dress of this variable is not 
that machine language programs 
ly be relocated to new positions in 


Subroutines сап also be called conditionally. This is the machine 
langage equivalent of the basic statement: 


IF (condition) then GOSUB (line) 


Care should be taken when in a subroutine so as to not affect any 
я or registers which are needed for the next compari: This 
you don't branch off again on а following CALL statement, 
‘after returning to where you left off." 


The difference is that the only conditions allowed are the status 
of four of the flags: 


Parity flag (also overflow flag) 
Sign flag 


Remenber that all these flags аге set according to the L 
instruction which affected that particular flag. 


lt is therefore good practice to have 'CALL' or "RETURN" 


instruction immediately after the instruction which sets све flay 
св. 15 А, (Nunber) 

er 1 

САШ, 2,0пе 

cr 2 


CALL 2,790 
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TEL ЕС 
CALL — Z,Three 


The above routine allows you jump to various routines depending on 
the value stored in the location ‘number’, but note that it assumes 
that the subroutines do not change the value in Register A!!! 
(hy?) 


A shorter routine is possible if you know that there are only the 
above three possibilities for the value stored in 'number': 


ш A, (umber) 

[3 2 

CALL. 2,100 1 9 7 2 

CALL C. One ВА =) ла 
call Three зА) 2 =) ae 


This is because the instruction "СР 2! sets both the zero and carry 
flags and the call instructions do not affect any flags. 


Similarly the use of the conditional return from a subroutine ік 
very useful. (But not considered to be good programming practice). 


Instructions for Block Compare and Move Group 


Mnemonic Bytes Time Effect on Flags 

Taken C 2 PV SNH 
ші 2 4% = оно 
100 2 16 СИ е 
шик 2 ane -- о-оо 
шк 2 зе - - 0-00 
с 2 d И „ 
сто 2 6 - жя» 
сек 2 ane - £414 
СРОК. 2 лө - # erais 


Flags Notation: 


„ Indicates flag is altered by operation 
O Indicates flag is set to 0 
1 


Indicates flag is set to 1 
Indicates flag is unaffected 


Timing: 
For repeat instructions, the times shown are for each cycle. The 


shorter time indicated is for the case of the instruction 
terminating - eg. for CIR, either BO = O or A= (ML). 


Block Operations 


You should by now be very familiar with the Language your computer 
understands - it's very much like learning a foreign Language: 
when you can think in that language you know you have mastered it. 


This chapter covers the last set of very useful instructions - the 
next few chapters deal with instructions that are nice to have 
around and in some circumstances come into their own, but in 
general terms you should be able to write machine language programs 
with what you already know. 


Be sure however to read the chapter on planning your machine 
language progran! 


The instructions covered in thís ch 
able to leap tall buildings in a single bound, faster than a 

ding bullet - in other words, instructions which can operate on 
а block of memory rather than Just single B-bit byt 


are by their very nature 


Let's start with the simplest of these: 
ст 


With your knowledge of the 280 language, you should be able to 
immediately recognise this as a member of the "compare" family, and 
it is in fact an extended compare. 


Tt is read in English as 


овраге and incre (You will 
that one can only compare anything with the contents of 
Register 'A', and this does not need to be mentioned in the 
instruction.) 


CPI" compares "А" with (HL) and increases HL automatically. This 
means that after the CPI operation, HL is already pointing to the 
next location ready for а repeat. 


With such am instruction we might be able to write a routine to 
search all of memory for a particular match, as follows: 


Search ст 
JR М2, Search 


In this way, unless a match is found (zero flag will be set as in 
all compare instructions) the program will keep on looking. 


Unfortunately this is mot such а good idea because unl 
is found the program will never end! Fortunately the des: 
the 280 language thought of this and the CPI instruction also 
automatically decreases BC! 


We cam therefore select at will the length of the block we wish to 
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search through and thus specify ап end to the search. 


Let's assume that the length of the block ме are searching through 
їз less tham 255 bytes long, во that the BC count would only be 
stored im the C register, we could write: 


Search CPT 
JR 2, Found 
тес 
DeC С 
ЈЕ NZ, Search 

Notfound ~ 

Found "ERG 


Obviously a different routine would be implemented if the length of 
the block vas тоге than 295 bytes. Note the use of the INC and DEC 
instructions to test whether C = 0. These two instructions only 
require one byte each, and as they both affect the zero flag the 
met effect is to set the flag only if C vas originally zero. The 
other benefit is that this coding does mot alter any of the other 
register: 


Now we could also wish to search a block of memory starting from 
the top rather than from the bottom, and we therefore have the 
instruction: 

сто. 
which is read im English as 
refers to NL of cour 


опраге and decrease". The decrease 
and the effect on BC is still the same! 


Even more powerful than these two instructions are the real 
supermen: 


These are read as 
and 


compare, increase and repeat 
compare, decrease and repeat". 


These 2-byte instructions are unbelievably powerful: they allow 
the CPU to automatically continue searching through the block of 
memory until either а match is found or the end of block is 
reached. (Naturally we have to specify А, HL and BC before 
starting, but even so this is unbelievably economical coding). 


Because the instruction will stop for опе of two possibilities (le. 
match found in middle of block or по match at all) ме have to 

ensure we use some code at the end to differentiate between the two 
possibilities. 


You should be aware however that no matter the speed of machine 
Language, СРТЕ and other similar instructions can be very time 
consuming instruction: 


по 


CPIR, for example, requires 21 cycles for each byte to be searched. 
Admittedly there are 2,500,000 cycles in each second, but even so 
this means that searching through 3,500 bytes requires 1/50th of a 
second. 


This may not seem like a very long time to you but when you realise 
that the screen is displayed every 1/50th of a second or so you 
realise that it can be significant. 


The remaining block operations are along the lines of 
"Номе it, Mate": 


These arer 
ш шік 
150 шә 

Obviously part of the "load" family these are read as; 


Taking the simplest one first, 'LDI' is really a combination of the 
following set of actions: 

Load (DE) with (HL) 

Increment DE, HL 

Decrement ВС 


Note that this is the only instruction that will load from one 
memory location to another without having to be loaded into a 
register first. 


The use of the 'DE' register as the destination address is very 
clever - this мау you never forget which register holds the 
de-stination address! 


The symmetrical instruction 'LDD' is exactly the same except that 
HL and DE are decre. loading proceeds. The difference 
between "ПОТ" and 'LDD' ís more important when the смо blocks (the 
one where the information is and the one where the information is 
going) overlap. 


Suppose we are using this Instruction in a word processing 
application, and ме want to delete a word from a sentence: 


The big brown dog jumped over the fox. 
7913 5791357913579 


ТЕ че want to delete the word ‘brown! all we need to do is to move 
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the rest of the sentence to the left by 6 characters. 
DE - destination character 9 
НЕ source character 15 
ВС = count = 24 characters. 


Let us start with LDI: after one instruction we have 


original = The big brown dog jumped over the fox. 
move one chari d (-—d 
new = The big drown dog jumped over the fox. 


and WL = 10, DE = 16, BC = 23. 


After 2 more instructions: 
The big dogwn dog jumped over the fox. 


And 


fter all the instructions have been completed: 
The big dog jumped over the fox.e fox. 


(IE ме had wanted the portion after the full stop to be blanked out 
this could have been achieved by adding blanks at the end of the 
original sentence and increasing BC to say 20. 


Lf ме now want to reverse the process and return the word "brown! 
to the sentence, we can't simply use 'LDI' again because ve vill 
overwrite the information ме want to shift: 


p HL = Source = Character 9 
DE = Destination = Character 15 
BC = Count + 24 Characters. 


After one instruction ме would have: 
original = The big dog Jumped over the foxe fox. 
nove char а 

new = The big dog Judped over the fox.e fox. 


After 6 instructions ме would haver 
The big dog judog juver the fox.e fox. 


ood. But another three gives: 
в dog judog jud og the fox.e fox. 


‘The problem is that ме have overwritten the information we want to 
transfer. You can verify this by trying to move one character at a 
time yourslef by hand. 


It is therefore better to use the 'LDI' instruction, with the DE 
register pointing to the end of the sentence.x This will ensure the 
information woll not be overwritten in the move. 

The instructions 'LDIR' and 'LDDR' are even more powerful, able to 
shift thousands of bytes around very quickly. 
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Exercise: 


Write а short routine to transfer 32 bytes from the ROM part of 
memory to the screen. 


Note how the 32 first byt 


im the screen are arranged. 


Now try 256 bytes, then 2048 bytes. 
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Instructions that аге 
less frequently used 


m 


Register Exchanges. 


We briefly discussed im the first few chapters the ídea of the CPU 
having gloves it could put on or take off, and thus store some 
information im а place that is more accessible than memory 
locations. 


You must remember that you cannot manipulate these alternate 
registers and the analogy with gloves ís a very valuable one. 

While they will retain their shape, there is по way they can do any 
arithmetic or counting by themselve 


The first instruction is: 
ЕК АҒАР 


This does exactly what its name suj the register 
pairs AF and АР". In the gloves analogy we would say "Swap gloves 
оп the pair of hands AP". In other words, put on the t of 
AF gloves - you will remember the spare set is alvays denoted as 
AP 


The next general swap gloves instruction [s: 
Exx 


This instruction swaps the gloves on all other B-bit registers 
follows: 


вс в с 
D E (ey Dr 
"oL въ 


This is therefore а very powerful instruction but (св very power 
makes it limited in use. This ís because it acts on all the 
registers at once and it 18 not possible to hold апу value back. 


(Except in register 'A' which de not affected by "EXX"). 


The only way around this problem {з to write a short routine along 
the lines of: 


тн н 
EXX 
тор [3 


This means that you have saved the values of BC, DE and HL in the 
alternate set of registers but still have HL's value to work with. 


The last instruction im this group does not really fall within the 


swap gloves type: 
EX de, 1. 


ns 


1n this instruction DE gets the contents of НІ. and HL the contents 
of DE. 

This instruction is indeed very useful, because as ve зам WL is а 
favoured register pair in many applications and there are times 
when the value we vant to manipulate is in DE. 
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Bit, Set and Reset 


So far all the instructions we have been dealing with have involved 
the manipulation of 8-bit or 16-bit numbers. 


The "Bit, Set and Reset" group allows us to manipulate the single 
fingers on the CPU's hand (single bits of the registers) and/or 
contents of memory locations. Because of the very tedious nature 
of fiddling vith single bits this 15 not а very commonly used group 
of instruct tons. 


Furthermore, it tends to take even longer to set a single bit in a 
register or memory location than it does to change or examine the 
entire 8 bits of that menory location or register. 


Nonetheless there are times when you need to know whether a bit in 
the middle is set ог not, or even to set a bit. Note however that 
many of the bit setting or resetting can be carried out using the 
logical operators. 


The "Bit, Set and Reset" group of instructions allows us to turn 
any bit "om" or "off" at will, or even just look at a specifi 
to see what its status is. 


bie 


Let us look at the first set of instructions: 


SET n, г 
SET n, (NL) 

SET п, (IX + d) 
SET n, (IY + 4) 


The "SET" instruction turns "on" (i 
(using the notation O - 7) in regisi 
memory location. 


= 1) the bit numbered 'n' 
r 'r' or in the specified 


No changes are made to any of the flags. 


The "RESET" group of instructions operate on exactly the same range 
gisters or memory locations, but instead of turning the bits 
it turns the bits "off" (te. = 0). 


The "BIT" instructions should really be read as "BIT?" in English 
as the function of this instruction 1s to test the contents of the 
indicated bit. 


No changes are made to the registers or memory locations but the 
zero flag (s altered according to the status of the bit tested. 


If Bic 
Tf Bit 


© then zero flag is set on ( = 1) 
1 then zero flag is set off (= 0) 


n 


This may seem confusing at first glance but think of it this way: 
if the bit is zero, then the zero flag is raised; if the bit is on, 
then naturally the zero flag would пос be raised. 
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Rotates and Shits 


You can move them to the left, you can move them to the right, you 
can shift those registers any way you like. 


Тһе trick is to differentiate between the various shifts and 
rotations in order to know which one to use when, and to remember 
that the ‘carry’ bit can often be considered to be a 9th bit of the 
registers. (ie. the carry is bit number 8 if the bits are munbered 
0-7). 


Some rotate instructions go right through the carry (as the 9th 
bit) so that the entire rotation goes through a cycle of 9 bits. 


Тог example, let us look at 'RLA' (the meaning of each instruction 
will be made clear later in this chapter): 


Other rotations involve only an B-bit cycle, although the carry 
18 changed according to the bit which has to go the ‘long way 
round. Ав example of this is the "КЫСА" instruction: 


This means that in a left rotation as above the contents of bit 0 
are transferred to bit 1, bit 1 to 2, etc., but the contents of bit 
7 are transferred to both the carry bit and to bit 0. Compare this 
with the "RLA' instruction above where bit 7 gets transferred to 
the carry bit and the carry bit gets transferred to bit 0. 


Left Rotations: 


There are basically смо types of left rotations: 
* ROTATE LEFT REGISTERS 
illustrated above for 'RLA' 


RLA - "Rotate Left Accumulator" 
RL т - "Rotate Left Register r" 


Ка) 


по 


this is a 9-bit cycle rotation as 


+ ROTATE LEFT CIRCULAR - the 'circular* means that the cycle is 
only 8-bits as with the ВИСА instruction illustrated above. 


RLCA = Rotate left circular ТАР 
RLC с — Rotate left circular r. 
RLC (HL) = Rotate left circular (HL) 
RLC (IX + 4) - Rotate left circular (IX + d) 
RLC (IY + d) - Rotate left circular (IY + d) 
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As well as these two left rotate instructions there is a shift left 
instruction available, but this can only operate on register "A': 


Sia d Shift Left Accumulator 


Eiu-p——— e 


This is different in that the contents of the carry bit are lost 
and bit zero is filled with o. This is effectively multiplying 'A* 

w as nothing is transferred to the accumulator. (Think 
4E A = ВОН). 


RIGHT ROTATIONS: 


Once again ме have the two basic modes of rotations but this time 
to the right. Exactly the same range of possible mesory locations 
and rotations can be spinned to the right as to the left. 


RRA betete Right Accumulator 
r - Rotate Right Register 


Цв ста 
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RRCA betete Right Circular ТА" 
RRC r — Rotate Right Circular 'r' 
RRC (HL) — Rotate Right Circular (HL) 
RRC (1Xed)- Rotate Right Circular (1X+d) 
RRC (1Y«d)- Rotate Right Circular (1¥+d) 


ол | а) 


А similar shift right is available as Гог shift left: 


SRL r - Shift Right Logical Register 'r' 


па 


In this case this is pure division by 2 ав long as ме are using 
unsigned numbers (іе, the number range ме wish to represent is 0 - 
255). 


Because in some applications ме use the convention to indicate 
gative numbers by setting bit 7 to | (le. giving us a range of 
-128 to +127) there is ап addition shift right instruction called 
SRA ғ - Shift Right Arithmetic "r^ 


Аз you сап see this is also а 
division by 2 but it preserves 
the sign bit. 
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In and out are just about а simple а concept as you could get in 
machine language programming. 


There are times when the CPU needs to get information from the 
outside world ("No CPU is an island?"), such as from the keyboa:d 
or from the cassette player. 


As far as the CPU is concerned that's totally foreign territory and 

all good CPUs it will never leave home. The most it is prepared 
to do їз to open a door to allow deliveries. The CPU doesn't know 
and doesn't care to know how a cassette player works. 


ALL the relevant information (s which door the cassette man is 
going to be delivering his goodies to - thei choice of up to 
256 doors for the 280 chip but the actual number available to a 
particular CPU is a result of decisions made by the hardware 
there is only 


The other thing the CPU doesn't want to know about is how the data 
is being transmitted. Ав far as it's concerned, if it's coming in 
ог going out, it's ап 8-bit by 


Тһе keyboard and the cassette player are both on the other side of 
door РЕН (254 in decimal), so that to get data in from the keyboard 
you use the instruction 

їн A, (FE) 


Now you may be asking yourselves how the 40 keys of the keyboard 
are arranged so as to be represented by 8-bit bytes. 


The answer de not what you would expect - the keyboard only returns 
information from 5 keys at a time. ТЕ is the value of ЗА" as the 
door is opened which determines which set of 5 keys are going to be 
examined! 


The keyboard is divided into 4 rows, each comprising two blocks of 
5 keys: 


о 
меке 


в 
1 

к LN/L (6 
М . SPC (7 


мото 
Pr 


You сап see that there are 8 blocks of letters and we should 
therefore be able to correlate this with the В bits of ‘A'. 
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This is in fact the case: 


ALL of the bits of 'A' are set to "ОМ! except for one bit which 
specifies the block to be read. 


You сап think of it as something like a secret handshake — as the 
CPU goes to the door to get the information the handshake 
determines which piece of information it gets. 


Thus to read the keys in the block "I 2 3 4 
which should be off: 
А + LULL 0111 =F7 


у dt is bit 3 of 'A' 


The contents of the keyboard are returned in "А" with the 
information coming into the lower bits of ' 


des Key . =) оов" 
Key . -) ви 1 of ‘At 


ТЕ block 4 was chosen inst 
would come in as: 


4 (ie. A = EFH) then the information 


Key '0' -) Bit O of ‘A! 
Key =) Bit dot tah 


im think of the information coming into 'A' from the outside 
у во that both 'O' and "1" would both go to bit '0* of 
register ‘A's 


ог some games applications you may wish to allow all of the top 

it all in one 
instruction (rather than the two instructions which would be 
one block at a time). 


This is done by fooling the doorman into giving you two lots of 
information at once: 

eg. A= 1110 011 1 «87 
Note that both bits '3' and '4' are ‘OFF? 


This handshake tells the doorman that the CPU vants the information 
from block 3 and block 4, and that is what it will get. Of course 
the two lots of information get jumbled and it is mot possible for 
you to tell whether key '0' or key 'l' vas pressed, for example - 
both would set bit O of "А". 


ie. 1. өсе — 
"25 er 19" 2) ви 


This is useful in movement games because it enables keys '5' and 
8" to be used as the left and right direction arrows even though 
they belong to different blocks in the keyboard. 
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Note that if you use the instruction 

їн т, (с) 
where register С Specifies which door you want, then it is the 
contents of register B which define which keyboard block is being 
selected. 


The other doors which may be of interest to you are obviously the 
cassette input/output doors. 


This is still door FE, аз mentioned above, The major problem 
involved is the timing of the data going out and going in; this 
kind of problem requires а lot of experience with machine Language 
programming and calculations of the time required for each 
instruction path. 


The OUT instruction is also used to generate sour 
and to set the border colour. 


on the Spectrum 


ge 160 of the Spectrum manual discusses the BASIC OUT 
instruction, and machine code programming of the OUT command is. 
exactly the same. Im other words, bits O, 1 and 2 define the border 
colour, bit 3 sends a pulse out Lo the МІС and EAR sockets, while 
bit 4 sends а pulse to the internal loudspeaker. 


the border colour, load A with the appropriate colour 
then execute the OUT (FE),A instruction. Note that this 
15 only a TEMPORARY change in border colour. To change the border 
colour permanently, you must perform the above OUT instruction and 

change the value of the memory location 23624, which is the 
ting system's variable BORDCR (see page 174 of Spectrum 
manual). 


The reason for this de that the hardware in the Spectrum (the ULA 
chip in the Spectrum) controls the border colour, and that it 
obtains its information by looking at the contents of that memory 
location. You can stop the hardware from messing about with the 
border colour only if you disable all interrupts (01 instruction). 
Note that sone of the subroutines in the ROM re-enable interrupts 
(EL instruction). 


Creating your own sound: 


You can create your own sound on the Spectrum, but there are some 
Limitations due to the hardware construction for users with only 
16K of RAM. 


Because the screen їз constantly being updated, the hardware 
regularly interrupts the Z80 from performing its tasks in order to 
show what is on the display file. This is done by bringing the WAIT 
line low. 
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The effect of this is that апу program that requires exact or 
regular timing is impossible as it is not possible to predict the 
timing effects of these WAIT interruptions. The design of the 
Spectrum is such that the 280 is only interrupted if the 280 is 
trying to process information contained in the first 16K of RAM. No 
such interruptions occur if the program and data the 280 is 
accessing is im the ROM or іп the upper 32K of memory. 


To sumarise this in layman's terms: you can produce sounds and 
noises using the OUT command if you have a 16K machine, but not 
pure notes. (ТЕ is possible со get around this by calling the ROM's 
BEEP routine - see the chapter on the Spectrum's features). 


To create sound, you need to send a pulse to turn on the 
loudspeaker (and/or MIC socket if it is to be amplified). Then а 
little while later, you need to send another pulse to turn it off. 
Then a little while later, on again, ++ 


In this way sound Is created. The total length of time between 
turning the loudspeaker on and the next time you turn it on again 
determines the frequency of the sound. The length of time you leave 
the pulse ON, as opposed to the total time between pulses can give 
you а minimal degree of control over volume. 


Note that you must use a value of A for on and off such that the 
border colour remains unchanged. Otherwise, you will get a banding 
pattern similar to the LOADing pattern. 


Exercise: 


Write а routine which simulates an ambulance siren (frequency 
increasing, then frequency decreasing). Note that you must sound 
each frequency for а short period before moving on to the next 
frequency. 
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ВСО Representation. 


BCD stands for binary-coded decimal. This is a way of representing 
information in decimal format. 


In order to encode each of the digits from 0 to 9, only four bits 
are necessary and six of the possible codes will пос be used in 
this representation. 


Since four bits are needed to encode a decimal digit, two digits 
тау be encoded im every byte. This is called BCD representation. 


eg. 00000000 18 BCD representation for decimal 00. 
10011001 18 BCD representation for decimal 99. What is the 

BCD representation for "S8"? "10 

1s "10100000" a valid BCD representation? 


BCD ARITHMETIC 


ще convention in representing numbers can lead to 
problems in addition and subtraction. 


liding the following 


во 08 0000 1000 
мо оз 0000 0011 


ю 11 0000 1011 


You will notice that the result of the second operation ís wrong 

and is am invalid BCD number. To compensate бесігі instruction, 
АА", called "decimal adjust arithmetic" must 

the result of the addition. (ie. Add 6 if the result de greater 

than 9). 


The next problem is illustrated by the same example. The carry will 
be generated from the lower BCD digit (the right-most one) into the 
left-most one. This internal carry must be taken into account a 
added to the second BCD digit. 


The "half carry flag ", Н is used to detect this carry. 


ш A, їн 
ADD A, 24H _ јада literal BCD "24" 
DAA sdecimal adjust result 


їр (addr), A store result 


You will be unlikely to use BCD representation in your programming. 
But ít is good to know that the 280 chip still supports this 
representation and the DAA instruction will make the life of a 
small group of BCD users simpler. 
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Interrupts 


Am interrupt is а signal sent to the microprocessor, which may 
occur at amy time and vill generally suspend the execution of the 
Current program (vithout the program knowing it). 


Three interruption machanisms are provided on the 280: the bus 
request(BUSRQ), the mon-maskable interrupt (NMI) and the usual 
interrupt (INT). 


From programming point of view, we will only look into the usual 
maskable interrupt (INT). 


The DI (disable interrupt) instruction їз used to с 
while the EI (enable interrupt) instruction is used to 
(unmask). 


t (mask), 


Generally, am ordinary interrupt will result in the current program 
counter pushed onto the stack follows Бу a branch of execution to 
the zero page of the ROM by the RST instruction. A RETI (return 
from interrupt) instruction is required to return from the 
interrupt. 


Та normal operation, the Spectrum has interrupts enabled (EI), ar 
in fact the programme is interrupted 50 times per second. This 
interrupt allows the keyboard to 


You may wish to disable interrupts in your programs as this will 
execution. You can still read the keyboard as long as you use 
your own routine to do so. 


Be sure to enable interrupts when you finish from your program, 
otherwise the system will not be able to read the keyboard! 


э? 


Restarts 


This is rather a "leftover" from the 8080 implemented for 
compatibility. That is why you will be unlikely to use RST 
instructions in your program. 


of eight addresses in th 
OBH, тон, 188, 20H, 28H, ЗОН or 38H. 


vantage of the RST instruction is that frequently called 
utínes can be called using only one byte. The RST instruction 
also takes less time than a CALL instruction. 


The disadvantage of RST instruction is that it can only be used to 
call one of the above eight possible locations 


As all those locations are within the ROM, you cannot gain this 
advantage in your own programs. It is possible however to make use 
of the ROM's subroutines if you know what they do, and thus use the 
RST instructions. 


You will be able to know more about the RST instructions from our 
book "UNDERSTANDING YOUR SPECTRUM" by Dr Ian Logan. 
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Programming 
Your Spectrum 


Planning Your Program 


Machine language programming is extremely flexible in that іс 
allows you to do anything at all. 


Since all the higher level languages ultimately have to come down 
to machine language, it follows that anything you can program in 
Fortran or Cobol or any other language can be done in machine 
langoa 


With the additional benefit that the machine language program will 
be the faster on 


This total flexibility can however also be a tr. 
programmer. With so much freedom, it is possible to do anything. 
Unlike the SPECTRUM's BASIC оре example, there 
are по checks on whether the stati one. 


to the unvary 


Since all numbers you can enter will be ап instruction of one kind 
or another, the 280 chip will process everything 


Вог even beyond the problems of checking whether the syntax is 
legal, machine language programming has no constraints on your 
logic — you can perform functions, jumps, etc. which would be 
totally illegal in any higher Level Language. 


тє £s therefore of the utmost Importance to discipline yourself in 
the design of machine Language progranming. I cannot recommend too 
highly the concept of the ‘top-down’ approach in programming in 
general, but especially in machine language programming. 


The ‘top-down’ approach forces you to break down the problem into 
smaller units, and enables you to check the logic of your design 
without doing amy coding for a long time. 


Suppose you wanted to write a lunar lander program: 
The very first approach might be something along the lines 


INSTR Display instructions. 
Jump back to INSTR till ENTER pressed 
DRAW Draw landscape, start Lander at to 
LAND Move Lander 
1f fuel finished go to CRASH 
Jump back to LAND if mot ground 


GROUND. Print Congratulations 
Jump back to INSTR for next CO 
CRASH Print commiserations on bad landing 


Jump back to INSTR for next CO 
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Notice how this ‘program’ is written totally in English. At this 
stage, по decision has been made whether the program is to be 
Written im BASIC or machine language. Nor is it necessary to make 
that decision - the concept of the Lunar Lander program 15 mot 
dependent on the coding. 


Now comes the part of logic testing. 
You play the part of the computer and see if all the possibilities 
you wish te see included in the program are covere 


Are there any Jumps to things you meant to write Їп but forgot? Is 
everything there? Are some routines redundant? Should some of the 
things be put into subroutine: 


Let us look at the ‘program’ again - oh, oh: ме forgot to allow any 
way to finish the program 


The above logic might be fine for some applications, such as an 
arcade machine, but in your program you may decide you would like 
to be able te turn the program off. 


Ме пом change the last part of the program as follows: 


GROUND. Print Congratulations 
Jump to Finish 
CRASH Print commiserations on bad landing 
FINISH Ask player 1f finished 
1f mot, jump to INSTR 


1f yes, STOP 


Note that we have used labels to describe certain lines in 
program. These are very valuable, the more во if you choos 
labels which are descriptive in their meaning. 


Once this level is finished, you move one level down to do the same 
thing to one of the limes or modules above. 
This is why this approach is called the top down approach. 


For example ме can expand the "finish module above: 


FINISH Clear screen 
Print "Would you like to stop now?" 
Scan keyboard for input 
ТЕ input = yes then stop 
Jump to INSTR 


Тһе other benefit of the top down approach is that you can test and 
run a particular module on its own, во that it is ready for the 
final program. 


Let us go down one level further again, and look at the 
Clear screen 


am 


line in тоге detail. 


By this stage we do have to decide on what language ve will write 
the program іп, and let us choose machine language оп the Sinclair. 


ТЕ you were writing in BASIC, all you would have to say is: 
900 CLS 

but in machine Lang 

deceptive.) 


је that simple sentence, ‘Clear screen can be 


We might therefore do something Like: 
CLEAR Find screen beginning 
FAIL next 6144 positions with blanks 


We still haven't done any coding, but obviously the approach is 
based on machine language. Let's look more closely at exactly what 
s clear screen routine is meant to do and what it will actually 


You may recall from the Spectrum manual that the screen is made up 
of 6144 locations, and that there are a further 768 locations which 
describe the attributes of the screen - paper colour, ink colour, 
and so on. 


The short program description above will indeed clear the screen 
portion, but does not have any effect оп the attribute file. If not 
all the screen has the вате paper colour, or if some character 
positions have flashing or bright set ‘on’, then the clear screen 
routine above vill clearly be inadequate. 


to work on the attribute file 
complex certain t 


well. (Note how much more 
ks can be іп machine language than in BASIC.) 


fore need to expand the program to read 
Find screen beginning 
next 6144 bytes with Ы 
tribute file beginning 
mext 76B bytes with paj 


nks 


r/ink desired 


The next level down is the one where you must finally do the 
coding, so let us look at filling the screen with blanks: 


CLEAR LD ML,SCREEN iScreen start 
їр b 6% sBytes to clear 
ш 0,0 Кичка 

100Р їр (йр ЧЇ blank 
INC ul. iNext position 
DEC BC Reduce count 
10 A,B 
OR C ;Test if BC = 0 
JR NZ, LOOP iAgain if not end 
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Now you сап deal with programs of such length quite easily and in 
this way build up very complex programs indeed. 

By the vay, you no doubt understand now why machine language 
programs tend to be so long and why people invented the higher 
language programs! 


There are more ways than one to write any particular routines, 
let us look at the simple clear screen routine written above. 


This could be handled by several different approaches. 

Exercise l: 

Can you think of a мау that would enable the loop to blank 6144 
positions without using the BC register, but using the B register 
only so that we may make use of the 'DJNZ' instruction? 


Exercise 2% 


Сап you think of а vay that would enable the 6144 positions to be 
blanked using the more powerful 'LDIR' instruction? 


Think carefully of what 'LDIR' does: it is пос always necesi 
have 6144 blank positions elsewhere! 


ту to 


Answers: 


More than one possible answer can be 
do 


ght" - the only test is 
it work? In other words does it do what YOU vant? 


Using DINZ: 
CLEAR LD ML,SCREEN 
збе B-24 
висгоор isave value 
iSet 2256 
LiTLOOP їр (пад i 
INC нь (РАТ in 256 blanks 
DINZ LITLOOP 
POP BC iGet back value of B 
DJNZ BIGLOOP iDo it until end 


We have been able to use 24 times 256 (-6144) to clear the screen. 
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Points of mote are: 
Же сап set В = 0 to go through the DINZ loop 
256 times. (Why?) 
This procedure would not normally be used im а 
program unless we were also using register C 
for other purposes. 


Using LOIR: 


CLEAR LD HL, SCREEN iSource 
PUSH HL 
POP DE 
INC DE 
LD BC, 6144 
їр (WL),0 
шик iMove it 


Note that ve have found DE = HL +1 by getting DE > HL and 
Increasing DE. This сап be achieved more easily by loading the 
value of SCREEN +1 into DE directly but this requires 1 more byte! 


The reason this LDIR works is because we are uying the fact that 
the data is overwriting the block to be written as ме proceed. This 
is using in a positive manner the problem we discussed in the Block 
Move Chapter. 


1f you add up the memory required, the first method requires 14 
bytes, the second 16 bytes, and the last 13 bytes. 
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Features of the Spectrum 


ТЕ is time then to have a look into Features of your 2X Spectrum 
that are useful when you develope machine language programs for 
it. 


Input - keyboard 


As far as input to the Spectrum is concerned, we will ignore 
Cassette input and concentrate on the keyboard. 


The keyboard is the only input which provides real-time 
communication. It can dynamically affect the processing of any 
either the operating system in ROM or the user's program 


Logically we can see the keyboard as a two dimensional matrix with 
eight тома and five columns as in appendix A. 


Each of the forty intersections represents а key of the keyboard. 
Tn their normal state (when they are not pri 
im a high mood ie. the interi 


When а 


ticular key is pres 
nding to that key will be re 


Knowing the relationship between the keyboard and this inner matrix 
representation, we can derive a logical vay of testing key pressing 
which can be used in machine language programming. 


In BASIC, when we scan the keyboard we need to provide an address 
for that particular half row of keyboard where the desired key 
resides before using the IN function as described in chapter 23 
(p 160) of the Spectrum manual. 


Similarly, im a machine language program, ме need to load into the 
accumulator a value corresponding to the address of the half row of 
keys we want to test. The required value for each half row is 
Listed in the leftmost column of the table in appendix A. 


sg. For the "Н — ENTER" half-row ме load А with value ВЕН 
1D A, вен 


The value in A will then be used to fetch the byte which contains 
the state of that particular half-row of keys and return to А when 
the INPUT instruction is issued. 
ев. The port used is the РЕН port 


їн A, (FEM) 


Since there are five keys рег half row, ме are only interested in 
the five low order bits of the returned byte in А. 


If no key is pressed in that half-row, the value of the low order 
five bits will be (2&4 + 293 + 2692 + 2841 + 270 le. 16 6 + 4 
5241-30. 


register А = xxx11111 when по key is pressed. 


If we vant to test whether the rightmost bit is pressed, we check 
to see whether that bit is Том. 


There are two ways to test tha 
1. Use Bit test instructions, eg МТО, А 
If the bit is low (not set) then the Zero flag 
be set. 
it. Use Logical AND instructions | AND 1 
1f the bit is low (not set) then the result will be 
zero and the Zero flag will be set. 


ми 


The first method is easier because the particular bit ме want to 
test is specified directly in the Bit-test instruction. But it В 
а shortfall in that if we want to test two keys of that half-row we 
Vill need to use two Bit-test instructions and possibly two 
relative jumps. 


To test bit 0 


1d bit 1 using the first method 


mto, А itest bit 0 of A set or not 
JR Z, NPRESS ijump if not pressed 
Mr 1. А itest bit 1 of A set or not 
JR Z, NPRESS Jump if not pressed 


do whatever if both are pressed 


The second method of testing using logical AND requires a little 
more logic. To test bit О we use "AND 1% to test bit 1 ме use "AND 
2"; to test bit 2 ме use "AND 4" and во on. 


To test two keys, ме use "AND x" where x is the sum of the value we 
Will use when testing each one key individually. 


eg. To test both bit o and bit 1 of A are se 


ар з est both bit 0 and bit 1 
iis set 
cr 3 itest if both set 


1% 


зе NZ,NBOTH — ijump if not both pressed 


To test Е either bit O or bit 1 of A are set 


аю з itest either bit O and bit 
ids set 
за Z,NOTONE _ ijump if пос one is pressed 


To summarise what we have learnt relating to the keyboard, сап you 
code а machine language subroutine trapping the (ENTER) key pressed 
for your Spectrum. 


You will need to 

heck the row address that needs to be loaded into А. 
md it to the input port РЕН. 
©. test the bit that is set by the (ENTER) key. 


эз? 


Output - Video Screen display 


The Video screen display is the main source of output for the 
computer to communicate to the user. 


The following machine language program will demonstrate the way the 
screen memory of the Spectrum is organised: 


210040 10 нь, 4000 oad ML with start of 
idisplay file 

err їр (ML), вен ifill that screen location 

110140 LD рЕ,4001н ilond DE with next byte 
iin display 

010100 10 вс 18C contains number of 
ibytes to be transferred 

bro DIR imove a block length BC 
ifrom (NL) to (DE) 

ce» ют zend of progr: 


Load the above program into your Spectrum and run the machine code 
Рі Тһе мау it is written above, one byte only will be 
transferred from (HL) to (DE). 


Now change the fourth lime to read 10 BC, 31 (011700). You may be 
surprised at which are the first 32 bytes of the screen display. 
Note how а very thin line has been drawn across the of the 
screen. The first 32 bytes of the screen memory relate to the first 
byte of each of the first 32 characters. 


Now change that line to read LD BC,255 (ОПРРОО). Again you may be 
surprised. The next byte after the 32nd one {в not.on the second 
row of dots on the screen! It is the first byte of the 32nd 
character! And so on up to the 256th character. 


Are you prepared to predict where the next byte would go? Change 
that lime to LD BC, 2047 (ФРР87) and run the program. You will 
find that the top third of the screen only has been filled. 


You can experiment with this, using different values for BC up to 
LD BC, 6143 (ФІРРІ?). In this мау you can watch the way Spectrum 
organises the screen. 


The screen memory is actually divided into three lots. 
i. Memory 4000H - A&7FFH (===) first eight Line: 
11; Memory 4800Н - GFFFH (<==) second eight Lines. 

iii, Memory 5000H - З7РЕН ( third eight lines. 


Not only that, but you will recall that each character of the 
Spectrum is composed of eight 8-bit bytes which makes up 64 дог 
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eg. For the character " ! ", its character represntation is 


о 00000000 он 
16 00010000 108 
16 00010000 108 
16 00010000 108 
16 00010000 108 

0 00000000 он 
16 00010000 10H 

о 00000000 он 


The organisation of the Spectrum screen display memory is such that 
the first 256 bytes from 4000H to GOFFH correspond to the first 
byte of each of the 256 B-byte character of the first eight lines. 


Then the next 256 bytes from memory location 41008 to SIF 
correspond to the second byte of each of the 256 &-byte character 
of the first eight lines and so on. 


Thus 

first character of the screen i 
ist byte 4000 
2nd byte — 41008 
Зеб byte 4200 
p 
Sth byte дон 
6th byte — 45004 
Tth byte 46004 
већ byte 42004 


Strang 
dolle. 


isn't de? But ме have to accept the Spectrum the way it i» 


Сап you write down tbe eight bytes that correspond to the 2146 


character line of the screen? You can refer to 
Appendix menory map. 
(АОЗЕН, 415EM, 425EN,... ,&75ЕН) 


To Follow on the concept we have developed about the screen 
display, the memory locations that correspond to the first 
character of the second eight lines lot is: 

воон, 4900M, адоон, авоон, 4COOH, роон, 4ЕООН, 4FOON. 


Similarly, the Hest character of the third eight lines lot has its 
vight-bytes in memory locations: 
5000H, 51008, 52008, 5300H, S400M, 53008, 56008, 5700M. 


There are some advantages, however, in using machine Language. The 
apparent complexities are worth overcoming. As a trivial example, 
im BASIC, if you try to PRINT into the input section of the screen 
(the bottom two lines), the BASIC system will object most 
violently. But in machine language you have full access to the 


whole screen. 


ТЕ you observe the screen display organisation more closely, you 
will see that the High Order Byte of First Byte (HOBFB) of each 


character determines which lot of the three memory portions the 


character is in. 
For example,if 40H =( HOBFB ( 416 
AE авн =( HOBFB ( 49H 


it 50H -( HOBFB ( 51H 


char is in first 
eight Lines lor 
char is in second 
eight Lines lot 
char is in third 


eight lines lot 


Not only that, the low order three bits of the HOB (High Order 
Byte) determines which byte of the eight bytes of the character it 
belong: 


Things starting to blurr now? Turn to appendix В and try to observe 
the relationship between memory locations and the display screen 
(LE атут). 


Try the following example: 
Suppose ме are given ап addr 
the address is ЗАМ so: 


аз ФАЗбН. The High Order Byte of 


i. we know that it ís within the screen display memory 
Since its value is in between 40H and 58H. 
її. des binary re 


entation is 01001010 


iii.from the lower three bits we know that it belongs to 
the third byte of à character position on the screen. 


iv. af we made the lower three bits zero, then the value 
‘of the HOB would be 48H. Thus we know this belongs to 
the second eight lines lot, {е the middle portion of 
the screen display. 


The conclusion we can reach is that the byte given refers to the 
third byte of a character in the middle portion of the display 
memory. 


Which character of the middle portion does the byte belongs to? To 
answer this question, we'll need to know the value of the Low Order 
Byte of the address. 


We know the LOB of the address is 36H. So the address refers to 
character 368 (4846), the 54th position avay from the first 
character of the middle portion. 


Since each line has 32 characters, the position referred to is in 


мо 


the second line of the middle screen di 
(54-32«1)th character of that Line, 


ay portion and is the 


The conclusion we can make is that the byte given is the third byte 
of the 23rd character of the 10th line from the start of the 
Exercise: 


Which byte of which character do 


the address 564РН refer to? 


Gan you write a short routine to write an exclamation mark to the 
screen? The bytes that make up this character are given above. 


ма 


Output - Video display attribute 


The display attribute memory is easier to understand than the 
display memory because it has a one-to-one relationship with the 
screen display characters, 


The attribute file is located іп memory from 5800H ro SAFFH. ТЕ is 
768 bytes, which correspond to 24 lines of 32 character each. In 
other words, there is one attribute byte for each character 
position. 


Thus, 5800H corresponds to the attribute of the first character of 
the first line, S&01H the second character, 58029 the 
third,...58IFH the thirty second character of the first line. 


Similarly, 58208 holds the attribute of the first ch 
second line, SB40M of the third line, ... and Sakon the 
of the first character of the last line of the screen. 


ter of the 
tribute 


We know that for each character position оп the screen, there is a 
corresponding attribute byte in the attribute memory, made up as 
follows: 


attribute byte. b b bbb bbb 

bto- 2 represents the ink colour of the 
character o to 7. 

CERT] represents the paper colour of the 


character o to 7. 
t Af 1, normal (f 0. 
мао. 


What is the address of the attribute byte that с 
first byte of the middle screen section? What is the 
the first byte of the third section? Answers are given оп the next 
page, but try to work [t out for yourself. 


Exercises 


Can you write а subroutine that converts a given address on the 
sereen to its corresponding attribute address. 
ex. 45298 


You most in effect determine which character of this screen this 
belongs to, and then add this to 5800H. 


The following program shows a short method of achieving this: 


ма 


ш он, 42% 
Ша, 


You may nes 


The мау the prog 
exercise: 


Ise char. of Ist screen 
Ist char. of 2nd screen 
Ist char. of 3rd screen 


2nd char. of Ist screen 
есе. уз» 


This should make things 


oad the given address to HL 
oad the high order byte to A 
itrap bits 3 and 4 to 
letermine which portion of the 
creen the address belong 
hift right accumulator 
ithree times - ie divide by 8 
iresule can either be 0,1 or 2 
idepending whether Н was 
АВН, ЗОН or 50H 
itransform to attribute memory 
IL contain attribute address 
Зан, 59H or 60H 
ins the same! 


to think about this for a while! 


section = 40004 
section = 4800W 
section = 50008 


section = ВОН Attribute add 


ete ees 


а little clearer! 


мз 


m works is related to the answer of the first 


звоон. 
59001 
5400W 


oni 


Output - Sound 


Another real time communication that your Spectrum microcomputer 
offers is sound. It would be a vaste ТЕ we didn't make full use of 
this facility. 


1m machine language on the Spectrum, there are two major ways of 
generating sound. 
1. Sending signals to the cassette output port 254 for 
certain duration of time using the OUT instruction 254, 
eg. OUT (254), А 
11. Set HL, DE to certain values and call the ROM sound 
routine used to generate sound. 
The input parameters are 
DE - duration in sec * frequency 
WL - (437,500 / frequency) = 30.125 
Then 
CALL — O3B5H. 


The first мау of sound generation has the advant. 
from any ROM call 
see there is 


of being free 
It de shorter in terms of time to execute. But 


Since the ША Is constantly accessing the first 16K memory of the 
RAM to perform the video display, your program, if it resides 
within the first 16K, will frequently be temporarily interrupted. 


If the program is generating sound, the sound will be in bursts of 
unpredictable duration. One solution is to move the part of the 
Program that generates sound to the higher memory region if you 
ave а АВК machine. 


1f you haven't got a 48K machine, then you can still generate sound 
using this method, but ít will not be 'clean sound’. You have to 
use the second method of sound generation (of calling the ROM 
routine) to get that result. 


Note that as we send values to output port 254, it vill also affect 
the border colour, and turn the MIC оп, as well as the loudspeaker 
depending on what value ís sent. Refer to chapter 23 (p 160) of 
your Spectrum user manual. 


оп the other hand, the ROM routine for generating sound In effect 
allows you to use the BEEP command from your machine Language 
program. You can think of the DE register pair as holding a value 
for the duration of the sound, and ML a value for the frequency. 
Experiment with different values for НІ. and DE until you get the 
sound you vant. 


The limitation of this method of course is that you are restricted 
to whatever sounds you can create with the BEEP command. 


LI 


Мопйог 
Programs 


EZ-Code Machine Language Editor 


This is a machine code monitor program that allows you to: 


i. INPUT your machine language program module in 
either a fully assembled format 
or а semi-assembled format with all relative 
jump and absolute jumps expressed in the 
form of line number, 


ii. LIST the source input program module. 


iii. DUMP the input program module into the specified 
menory addres: 


iv. EXAMINE a range of memory locations. 


У. SAVE EITHER the "source modul 
OR the dumped program in fully machine 
code format. 


Vi. LOAD а saved "source program" from the cai 


УЦ. RUN све dumped 


chine program module. 


Before using this monitor program to input any machine language 
programs, you must assemble your assembly language program. You do 
not need to calculate relative or absolute jumps! 


Your program module must not be greater zhan 800 bytes or more than 
200 instructions. 


You cannot load the final program below memory 31499 (in order mot 
to wipe off the Е2-соде program.) 


CONCEPT behind the EZ-code 


The concept behind this program is to enable you to enter machine 
code instruction in a numbered line format, mich like the listing 
of a BASIC program. 


Each lime of the "source program" (the name of the lines of machine 


"s 


code) has а lime mumber and up to 4 bytes of machine code. 


A major benefit is therefore the ability to "edit" any line. The 
"source program" can also be SAVED separately to tape, allowing 
work іп progress to be saved. 


А major innovation in thís program is the ability to insert 
relative jumps or absolute Jumps without having to calculate the 
numbers involved in any jump can be made by referring to the line 
number you wish to jump to! 


This means that changes can be made without problems even within 
the scope of a relative jump. 


The machine code of the "source program" is transferred to memory 
by the "dump" command. The resulting machine code сап also be SAVED 
to memory. 


EZ-code Instruction Summary 


Note that the first question the program will ask you is 
“Loading address". 


This is the address where you wish the machine code program to go. 
This cannot be below 31500. 


ee Entering LINES eee 
1. To ENTER lines of "source program": 


(1ine-no) (blank) (maximum of 4 bytes in Hexadecimal) 
CENTER) 


eg. 1 210040 will insert the machine code instruction 
LD HL,4000H into line number 1. 


Af. To EDIT a им 


(line-no) (blank) (retype new bytes) (ENTER) 


eg. 1 210140 will change Line number 1 to the instruction 
їр HL, 40018. 


iii.To DELETE an instruction line: 
(песто) (ENTER) 


eg. 1 (ENTER) will delete Line number 1. 


iv. To specify RELATIVE or ABSOLUTE jump 


(1ine-no) (blank) (Jump instruction) ("lower case "L" 
(Line-no) (ENTER) 


ев; 16312 represents the instruction JP to line 2. 
21811 represents the instruction JR to line 


жез» COMMANDS sene 


i. dump(ENTER) 
* dump the source listing into the memory starting 
from the specified LOADING addre 
* this must be done before running the machine code 
program. 


abbreviation: du 


и. exit (ENTER) 
* exit from the EZ-code and re-enter BASIC system. 


abbreviation: ex 


fit лаве CENTER) 
* list the first twenty-two instruction lines of the 
source Listing. 
* press any key except "n" and "BREAK" to continue 
listing 


abbreviation: 14 


List # (ENTER) 
* List twenty-two lines of the source listing. 
starting from line number /, a number between 
200 inclusively. 


and 


abbreviation: NO ABBREV 


iv. load(ENTER) 
+ lead a source listing module from the cassette 
replacing the existing module, 


abbreviation: lo 


у. mem(ENTER) 
prompt: Starting address: 
^ enter memory address you want to start displaying 
from. 
+ can be from 0 to 32767 for 16K Spectrum or o to 
65535 for 48K Spectrum. 


+ press "a" to exit memory examine mode. 


му 


abbreviation: me 


мі. mew(ENTER) 
* clear the current module and re-run the EZ-code. 
+ this is useful when you want to start coding in 
another program module. 
abbreviation: ne 


VAL run (ENTER) 

+ run the dumped program module from LOADING address 
you specified when you start running the EZ-code 
program or when you LOAD a new source listing. 

abbreviation: ru 


Viti save (ENTER) 
+ save either the source listing or dumped machine 
code onto cassette. 
prompt: Enter name: 
enter the name you want to us 
Source or Machine code: (s or m) 
enter s for source listing saving 
enter т for machine code saving 
Start tape, then press any key. 
make sure that the cassette 1 


ts properly 


press any key when the ci 
abbreviation: за 


ette is ready. 
notes 


1. ТЕ you don't want the result of BC register returned 
after running, change line 3090 to : 


restart the EZ-code + 

Either use RUN and resulting with all valables 
reinitialised 

оғ ове СОТО 2020 which returns the prompt 
Command or Line(###): v. 


Э. ALL numeric entry except machine instruction 
code has to be in decimal format. 


4. To enable you to insert additional lines in the current 
Listing, it is good to space out the listing. 
le.instead of entering instruction lines as 1, 2, 3 

enter as 1, 5, 10 etc. 
This will makes the input of the module more flexible. 


EXERCISE оп Е2-соде 


Enter the following code: 


210060 Ш WL,4000H Ин sereen 
110140 1р DE,A4001N 

дігі? 1р 86.6143 

JEFF їр A. OFFH 

n LD (iL), A 

DBO шік 

ЗЕТЕ LOOP:LD А, ЛЕН itrap BREAK key 
[D IN A, (ОРЕН) 

көт AND 1 

тока на, LooP 

су RET 


To enter the above code using EZ-code: 


(RUN) 


or 


or 
Command or 


(This is 20 then lower ci 


E 
Command or 
Command or 
Comand or 
Command or 


address: 


5001 
Line( 
Lined ees 
Line eee): 
(ілес деуі 
пева): 
песие): 
Line (#44): 
Line( H8 € 
Vine ec: 
pn 


CENTER) 
1 210040( ENTER) 
5 110140(ENTER) 
10 O1ff17(ENTER) 
15 зе CENTER) 
20 77(ENTER) 
25 edbo(ENTER) 
30 Зет (ENTER) 
35 dbte (ENTER) 
40 e601(ENTER) 
45 20130 (ENTER) 
UL", then 30. In other words 


NZ, Line 30) 


Line (айа): 
Line (###): 
Lise) 


50 cO(ENTER) 
list (ENTER) 
dump (ENTER) 


Line(###): men(ENTER) 


Starting address: 31500(ENTER) 


Command or 


m 


(this is the key to exit the memory 


Note how there must be a space after the Line mumbers. 
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EZCODE 
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100 
110 
120 
130 


140 


1000 
1010 
1020 
1020 
1040 
1050 
1080 
1070 


1080 


1090 
1190 
1110 
1120 
1120 

2600 
2010 
2020 

2030 

2040 

2050 

2060 

2070 

2080 

2090 


2100 


2110 
2120 
2150 
2140 


2150 
2160 
2162 


REM machine 

REM machine.code.monitor 

60 TO 9000 

DEF FN diss) = (s$ > "9")*( CODE s$-55) 
“(5% <= "9")*( CODE s*-48)-(s$ > "'").s2 

DEF РМ e toe = ((08 = "ca")*(O& = "da*) 
*(0* = "еа") (0% = "ачу +(0% = "c2*) 
*(0* = "d2-)*(0» = печ) + (0а = 427) 


+005 = "c3*i)-((08 = аве (0$ = 50") 
%(0% = "28")«(0$ = "207)+(0 = "18° 
+008 = "10722 

кем 


REM iN LINE.PRINTING.routine IRU 


CLS + PRINT АТ ze, 25; INVERSE on; FLASH oni "LISTING ІНШІ 


LET Е = ze + PRINT AT z 
FOR J = pli TO pi2 
ТЕ ch, оп) = ".." THEN GO TO 1110 
PRINT TAB tr- LEN STR® 2) J; ТАВ fri "a"s 
IF C$(J, tw, on TO оп) = "1" 
THEN PRINT C&(J, оп)" "св (3, tw)4C8(3, tr) 
* 80 TO 1090 
PRINT ce. on) "a"i Се, беду =." 
з Ce, rds "ap CHIT, 475 
LET F = Fton 
IF F = 22 THEM 60 TO 1120 
NEXT J 
PRINT ат 
RETURN 
REM 
REM UY mein.routine LBU 
INPUT “Command.or „Line (ниву з f де 
ТЕ ASC TO fr) = "2..." THEN GO TO mr 
IF ав (оп) > "9" THEN Бо ТО 3000 
LET k$ = не РОЯ К = on TO fr 
ТЕ да TO К) = "," THEN GO TO 2090 
LET књ = кездек То ко 
NEXT к 
ТЕК = S OR VAL кв = ze OR VAL кв > 1n 
THEN GO TO me 
LET J = VAL къз LET = J 
+ REM lineanumber „пове „бе „3 bytes 
LET ав gen TO ) 
LET ke = +" 
FOR К = on TO LEN at 
IF ASIK TO K) <> =. 
THEN LET кв = кёкде TO K) 
NEXT К 
LET ав = ке 
IF ав (оп) = 


ze: 


„ DET 


THEN 60 TO mr 


CLS = FOR I = on TO 7 STEF tw 
LET К = INT (I/twron) 
LET C (9, K) = ASI то топ) 
NEXT 1 
ТЕ Себа, on) = ".." THEN GU TO 2250 
IF п < TP THEN LET ТР =n 
IF п > BP THEN LET ВР = n 
бо TO 2320 
ТЕ n <> ВР ТНЕМ 60 TO 2280 
ТЕ ВР = on OR C$(BP, оп) <> "a." 

THEN 80 TO 2520 
LET ВР = BP-on * 60 TO 2260 
ТЕ n <> ТР THEN GO TO 2320 
ТЕ CF. on) <> "aa" THEN GO TO 2320 
ТЕ TP <> BP AND TP <> In THEN LET ТР = TP*en 
+ 60 то 2290 
LET ТР = on 
LET pp = п 
IF n < TP THEN LET pp = ТР * GO ТО 2380 
LET numip = ze 
ТЕ po = TF OR numip = 11 THEN GO TO 2580 
IF Calpe, on) <> "aa" 

THEN LET numip = numipton 


LET рр = ро-оп + GO TO 2350 
LET pli = pp * LET pl2 = ВР 
бо SUB 1000 

+ КЕМ print.a.block,o* lines 
80 TO ве. 

нен 


REM LLY Соплапочнаниткенихвиних LA 
LET ke = дес TO tw 
me THEN GO TO 5000 
ke = THEN STOP 
ks = THEN GO TO 4000 
ke = THEN 60 TO 7000 


THEN 60 TO 6000 
THEN RUN. 

THEN PRINT USR R 
THEN GO TO 8000 


arostinertki a aaa IRU 

LET pil = TF $ LET р12 = ВР 

LET п: = CODE aste TO &) 

IF LEN A$ > fr AND ni > 47 AND ni < 58 
THEN LET pli = VAL A (5 TO 8) 


во SUR 1000 
80 TO ar 
REM 


REM ДШ DUMP .routinestsssssrsss TEU 
CLS = PRINT AT ге, 25; INK оп; INVERSE on 
$ FLASH oni “DUMPING” + LET G = В 


PRINT AT on, зе; 

FOR 3 = ТР ТО ВР 

IF CS(J, сөз = "aa" THEN 60 TO 5470 

ТЕ C(J. tw, on ТО оп) <> "1" THEN GO TO 5580 

POKE В, ге 1 POKE Gon. ге + POKE Ste, ze 

+ POKE G+tr, те 

LET si = VAL cen, tw, tw TO tw)4C$ (a, жез) 

PRINT TAB tr- LEN STR& Jt INVERSE oni J 
$ TAB fri INVERSE ze: "." 
3 CQ, one" "аса, БС, tr? 
и e 

IF j| < ze OR jì > 1n THEN GO ТО 5450 

LET CJ = FN get, ond) 

PRINT TAB 17- LEN STR® jl; INVERSE сөз jl 
$ TAB 18% INVERSE зет "„"$ СОП, on) 
волта C82, вер "UP свет, te) nun 
+ сву, +7; 

ТЕ ABS CJ <> on THEN БО TO 5460 

LET dd = (ji > J- (1 € D 

LET ја = бе LET dp = ze 

ТЕ 31 = J THEN GO TO 5270 

LET cl = Jeda 

LET nl = ze з IF С®(с1‚ om = ".," 
THEN GD TO 5220 

IF C$ (cl, tw, on ТО оп) <> "1" 
THEN LET ni = one csg, te) <> У 

* (C9 (cl, tr) <> 5447) 
"свест, fr) <> › 

* 60 TO 5220 

LET TJ = FN oC (cl, om) 

LET ni = (TJ = on Wir (ТО = ony stw 

ТЕ cl = ji АМО dd > ze THEN GO TO 5270 

LET dp = dpen! 

IF cl = 91 THEN 60 TO 5270 

LET cl = сізді 

60 то 5180 

IF CJ = on THEN LET ја gese- tdd > зе) пъг 

* 60 то 5510 

IF dd > ze THEN LET ар = dp+2 

ТЕ dp > 126 AND dd < ze THEN GO TO 5460 

ТЕ do > 129 AND dd > ze THEN GO TO 5460 

LET V = 168 FN diC*(d, on, on ТО ол!) 

+ Ем d(CS(J, оп, tw TO tw)? 

POKE 6, V = LET В = Sten 

ТЕ CJ = on THEN POKE G, ja- INT (залак зак 

+ LET Ө = Gton = POKE B, INT (ja/ok) 

Е LET 6 = бесп è ВО TO 5360 

ТЕ dd < ze THEN LET dp = -dp 

LET dp = dp-tw + POKE 6, dp ғ LET Б = Ston 

PRINT “ок” 

60 то 5470 

FOR 1 = on TO 7 STEP tw 


>) 
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LET К = INT (1/tw*on) 

LET V = 168 FN d(C(J, к, on TO оп)» 
+ км все, К, tw TO tw)) 

IF V < ze THEN GO TO 5440 

POKE Б, V 

LET 6 = Geon 

меті 

60 TO S470 

PRINT "ва" 

NEXT J 

PRINT AT ze, 255 

+ GO TO ви. 

REM 

REM LNY Memory.displayssssssass LBU 

INPUT "Startingaaddress „ dm 

CLS = PRINT AT ze. ге; 

LET G = de : LET F = ze 

LET F = Fton 

+ PRINT TAB 5- LEN STR* Ө; G : TAB 

FOR I = on TO fr 

LET V = PEEK 6 

LET H = INT (V/16) 

LET L = v-168H 

PRINT ре (неоп) з Юе жоп) s "a"s 

LET 6 een 

NEXT 1 

PRINT "2" 

IF F <> 22 THEN GO TO 6050 

LET k$ = INKEVS * IF k$ = "" THEN GO TO 

<> "m" AND k$ <> THEN LET Е = 
+ POKE 23692, ак-оп + 60 TO 6050 
POKE 23692, on + PAUSE 20 + GO TO mr 


REM дну подривиниваниананвиних LBU 


PRINT AT ze, 253 INVERSE on; FLASH ont 
LOAD "source" DATA Ce 

FOR I = on TO In 
LET TP = 1 

IF cel. on) <> 
NEXT 1 

FOR I = 15 TO on STEP - 


4" THEN GO TO 7100 


LET ЕР = 1 

IF С®‹1‚ ог) <> "42" THEN GO TO 7140 
NEXT 1 

PRINT АТ ze, 2ũ 

60 TO 9150 

REM 


REM дну здусазвазававвававкияа TEU 


aanysheyawhen aa sready, 


6150 


"LOADING" 


8020 INPUT "Enter.name i пв 
8050 ТЕ n$ = "" THEN GO TO 8020 
8040 INPUT 
"Source.or.Machine.code ғ .(s.0r 4m)" 
з кв 
8050 IF k$ <> "s" AND k$ <> "т" THEN GO TO 6040 
BO&O IF k$ = "s" THEN SAVE n$ DATA СФО) + GO TO mr 
8070 INPUT "Starting.address t"; s 
8080 INPUT “Finishingsaddress 2,9 sf 
8090 LET sb = sf-ss*on 
8100 SAVE n* CODE ss, sb 
8110 60 TO er 
9000 REM 
9010 REM initialisation 
9020 LET ze = PI — РІ * LET on = РІ / РІ 
* LET tw = onton * LET tr = опећи 
$ LET fr = twetw * LET qk = 256 
$ LET ағ = 2020 + LET 10 = 200 
9025 BORDER 7 * PAPER 7 + INK on : INVERSE ze 
* OVER ze * FLASH ze $ BRIGHT ze 
* BEEP .25, 24 : BEEP .25, 12 
9030 DIM A(15) • DIM O$(tw) 
9040 LET TP = In з LET BP = on 
+ REM line.number „buffer 
9050 DIM Cé(1n, fr, tw) + REM holds,code 
9060 PRINT AT ze, 20: INVERSE оп; FLASH on 
з "INITIALISING" 
9070 FOR 1 = on TO In 
9080 FOR J = on TO fr 
9090 LET Ce (1, д) = "a 
9100 NEXT J 
9110 ВЕЕР .01, 20 
9120 NEXT 1 
9150 PRINT АТ ze, 205 
9140 LET 0% = "0123456769ABCDEF 
9150 CLS * PRINT "Lowest 
9160 INPUT "Loading „адаг 
9170. IF R < 31500 THEN GO TO 9160 
9180 CLS + GO TO mr 
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Hexload Machine Code Monitor 


This BASIC program can be a monitor program on its own as it can be 
used to WRITE hexcode onto the memory, LIST memory, HOVE memory 
content around, SAVE the memory onto cassette and LOAD from the 
cassette to memory. 


On the other hand we can use Hexload as а semi-linking loader for 
code created by the EZ-CODE program. This is because EZ-code сап 
only be used to input small modules of less than 800 bytes and 
less than 200 instructions. 


So for large programs, we use EZ-code to develop the modules and 
Save each module as machine code on cassette. 

Then we use HexLoad, which їз а mich smaller BASIC program, t 
these modules and link them together by moving the modules into 
their appropriate memory location: 


load 


We will actually 
FROG program. 


ly this technique 


we develop the FREEWAY 


Concept behind Hexload 


The concept behind Hexload is extremely simple. 
The monitor program actually set the RAMTOP of BASIC system to 
26999. 


That means you сап input your machine codi пумвесе between 
memory locations 27000 to 32578 for 16K Spectrum and 27000 to 65346 
for 48K Spectrum. 


Hexload is а straight forward machine code monitor program. 
It offers basic monitoring functions like: 

WRITE onto memory in Hex format 

SAVE from memory to cassette 

LOAD from cassette to memory 

LIST menory contents from a starting address 

MOVE memory contents from one locations to another. 


Hexload Instructions Summary 


WRITE 
Write code in MEX format onto the memory. 


Imput start of memory where you want to write to in 
decimal format in response to the prompt. 


The address is limited to 27000 - 32578 for 16K 
27000 - 65346 for e 
eg. Write to address: 27000(ENTER) 
b. Enter codes in hex format. 
c. Press "m" to return to main menu. 


2. SAVE 
Save memory to cassette. 
Procedure: 
а. Input memory from which saving starts, can be any 
address — 0 32767 for 16K 


0 - 65535 for 48K 
Input number of bytes to be 
Input паве of the module to be saved. 


tte is n 
Option of verifying the module saved on to the 
cassette. 

ТЕ is good to verify so as to ensure that 


there ís по corruption of the module during the 
saving procedure. 


Load machine code module from cassette. 
Input memory address to which the module is start 
loading. The address is limited to same range as in 
write comand. 

b. Enter the name used when the module is saved. 

1f you are mot sure of the name, just press 
(ENTERO. 


4. LIST 
Display memory contents starting from an address. 
Procedure: 
а. Input address start Listing from. 
Сап be any address as in SAVE command above 
Type any key to continue the display. 
c. Type "m" to return to main menu. 


Move memory contents from start address to finish 
address into new memory address. 

Procedure: 

Input move from memory, any address as in the range 

DE SAVE command. 

Input move until memory, any address as in the 

range of SAVE command. 

c. Input move to memory, address range as in WRITE 
command. 

You can even copy the ROM into RAM by using this 

command. 


eg. Move from memory: O(ENTER) 
Move until memory: 1000(ENTER) 
Move to memory: 32000(ENTER) 


this will move ROM 0 to 1000 to RAM address 32000. 


NOTES: Any of the input in above commands which breaches 
the address range will result in the input beii 
reprompted. 


EXERCISE: 
Try using this monitor to input the module ме have developed 
with EZ-code. 
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HEXLOAD 
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100 REM 
110 REM monitor .program 
120 CLEAR 269997: LET ze = РІ - РІ 
$ LET on = PI / PI т LET tw = anton 
а LET ак = 256 + LET Im = 27000 
+ LET ar = 140 + LET wl = 340 
130 60 SUB 2000 
140 сїз 
= PRINT “Start cof smachine.code.area = * 
1 
150 PRINT "menu" * PRINT 
* PRINT 
метке machine „собе. . 


160 PRINT 
+ PRINT 
i4 «Save. тасћапе „соб 


170 PRINT 
+ PRINT 
"аа „бола. machine code. s+... 


180 PRINT 
* PRINT 
aasalist .amachine собе. . 
190 PRINT 
з PRINT 
2. „моме. machine „сове. . 


ees 


appropriate „Кем. = 


220 ТЕ 9% = "m" OR gë = "ме THEN STOP 
250 IF 94 = "" OR gẹ < "1" OF g$ > "ве 
THEN GO TO 210 

240 сїз 
3 PRINT "Start ot machi ли 
1 l 
250 БО TO 500% VAL де 
200 REM LNY eiten LAU 
310 INPUT "Writelto.address s": d 
520 ТЕ d > тт OR d < Im THEN GO TO 210 
350 PRINT + PRINT “Write Address tl": d 
з PRINT "To.returntolmenu.enter "ти" т". 
ЗАО LET as = == 
= +" THEN INPUT "Enter her. „code + 
БЕЗ 
340 IF ав (оп) = "m" OR aston) = "M" 
THEN GO TO er 
370 IF LEN a$/tw <> INT ( LEN as/tw) 
THEN PRINT "incorrect entry": 
= во TO ма 


собе ore 


380 LET с = ze 
390 FOR + = 16 TO on STEP -15 
200 LET а = CODE a8(( lebten g = ond) 


410 IF a « 48 OR a > 102 OR (а > 57 AND a < 65) 
OR (a > 70 AND a < 97) 
THEN PRINT “Incorrect sentry "5 
3 во TO wi 
420 LET c = ceft((a < 58) f (0-46) 
+(а > 64 AND а < 71)1(а-55)+(а > 96)8(a-87)) 
430 NEXT $ * POKE d, c * LET d = оп 
440 PRINT a&( TO tw) * 
450 LET ав = a$(5 TO) 
460 IF d = UDG 
THEN PRINT 
"Warning уои „аге hosen the изет 
graphics area! 
+ G0 TO wl 
470 IF d = 006-20 
THEN PRINT 


620 INPUT “Number „of „bytes „бо „Бе, 
630 INPUT "Mame.of.the.routine + 
640 SAVE a* CODE a, п 
650 PRINT "ро „уос „мів „ко мегі fy?" 
660 INPUT v* 
670 IF ув <> "y" THEN GO TO mr 
680 PRINT "Rewind „Каре „апа „рг 
690 VERIFY a* CODE a, п 
700 PRINT “О.к.” = PAUSE 50 
710 GO TO ве. 
900 REM LNY LoadTX*Yrrrtirbri rii) IRU 
910 INPUT 
“оаа „М.С. .to.address.startingss. 547 
за 
920 ТЕ а > mm OR а < lm THEN GO TO 910 


"PLAY". 


950 LOAD а CODE a > 60 TO mr 

1200 REM AMY плакививининиивиљивињиа LRU 
1210 LET at = “0123456789ABCDEF " 

1220 INPUT “List sAddress :"i d 

1250 PRINT “Press. ""M"" to.return,to.Menu. = 
1240 LET а = INT ( PEEK 3/16) 


= LET b = PEEK d-16 INT ( PEEK d/1&) 
1250 PRINT di ТАВ 7: a*(a*on): a$(bton) 
1260 LET d = deon 

1270 ТЕ INKEYS 
1280 GO TO 1240 

1500 REM ДЫМ Моуенааваљаааљаканикаа IAU 
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т” OR INKEYS 


M" THEN GO TO mr 


150 
1520 

сто 
2540 
1552 
1556 

зво 
jen 
1220 
1620 
телә 
1640 

„чо 
тез 
2902 


2020 


толо 
2040 
Meo 


INPUT "Movelfror.memory вр fm 
INPUT ""cveluntil.memory 2,4; um 
INPUT "Move.to.menorv za"; tm 

ТЕ te > $m THEN SO ТО 1410 

LET те = te 

FOR I = £m TO um 

POXE mp, PEEK 1 

ЕТ mp = тест 

өт: 

30 то те 

тр dee, 

FOR Т = um ТО £m STEP -on 

РОМЕ то, PEEK T 

LET mp = mp-on 

rr т 

92 TO me 

LET RT = PEEK 237324708 PEEK 23733 
IF RT = 65535 THEN LET mm = 65347 
t LET UDS = 65567 

IF ЯТ = 12787 THEN LET mm = 32579 
+ LET UDG = 12599 

LET mi = INT (UDG/qk) 

POKE 23675, LOG-ni¥er $ POKE 23678, ті 
FETURN 


о 


Тһе 
Freeway Frog 
Program 
Program Design 


This program is about frogs hopping their way home by crossing from 
опе side of а highway to the other. 


There are trucks and cars and motor bicycles on the highway with 
police cars frequently patrolling the highway. 


Scores are given by the number of moves hopped from one side to the 
other si 


You must understand the game very clearly because you are the 
programmer. 

This із merely the problem definition s! 
Unless we can clearly define and understand the problem ít will be 
very hard for us to know where we are heading in the later stage of 
the design and development of the whole project. 


FREEWAY FROG program structure 


Now we can apply what we have learnt about TOP DOWN MODULAR program 
design. We proceed from very high level and divide the whole 
program up into well-defined logical modules. 


They are as follows: 


1. INITIALISATION 
perform all initial tasks. 


2. TRAFFIC FLOW 
control of traffic on the highway. 
This can again be logically subdivided into 
i. regular traffic flow eg. trucks, cars and 
motorcycles. 
it. irregular flow traffic eg. police сағ. 


3. тюс 
control the movement of the FROG, crash testing as 
well as home testíng. 


4. GENERAL PROGRAM CONTROL 
this part of the program takes care of the score 
calculation and display, testing for termination of 
the game. 


LI 


5. TERMINATION 
perform the house keeping job before returnis 
the program. 


from 


Developing the FREEWAY FROG program 


Та developing the FREEWAY FROG program we have divided tt into six 
stages. The division into these six stages follows very closely to 
the logical breaks shown above. 


With each stage of development, we vill have testing to ensure each 
stage is working before proceeding to the next stage. 


The six stages vill be: 


1. Data Base design 
involving the design of objects shape, the creation of 
dati for each object and variables that the program will work 


2. initialisation 
involves the setting up of the screen, and the 
initialisation of various variables. 


3. Traffic flow 

here we develop only the regular traffic flow and test it 
separately from the irregular police car appearance which involves 
different logic. 


4. Police car 
ме develop and t 


t the police car movement. 


5. frog 

this will involve testing of frog movement, moving the frog 
by blanking the old frog and drawing the new frog, test for 
crashing, calculating scores ...etc. 


6. Program control 
handles updating of highscore, restart of game, abortion of 
game, return from the program. 


Before we proceed to develop the stages of FREEWAY FROG, ме will 
introduce here a BASIC program which will adds up thecontents of a 
block of memory and generate the sum as а "checksum". 


You may find this checksum useful to check for data entry errors. 


9000 нм 
9010 REM checksum 


9020 INPUT “From addres: 
9030 ТНРОТ "To address 


9050 ғов I=f TO t 
9060 ШЕТ s-s4PEEK 1 
9070 меті 

9080 PRINT "Checksum: " 
9090 Go то 9020 


Enter the start of the memory block, then the end of the memory 
block which you want to do the checksum in decimal value. 
The BASIC program vill generate the checksum value 


Stage 1-Data Base 


жене Design of object shape kk 


As this is a two vay traffic game, ve need to d 
shapes: 


ign two truck 
а left truck shape and a right truck shape etc... 


For the FROG, there will be four possible directions and so there 
will be four shapes, one for each direction. 


Let us adopt the following convention for position of an object and 
for draving each object: 


1f the shape is composed of four characters 


TUE 
the position pointer will be pointing to character А. 


Character А 
is finished. 
Then we'll draw the next row up. That is, repositioning to one line 
above to character C. 


drawn first, then character B ...until the whole row 


Thus, ме will organise the shape datal 


Shape ABCD 


Don't forget that each character shape is defined as eight bytes. 


ТЕ we adopt the principle of drawing each character from top byte 
to the bottom byte, then we will need to organise the shape 
database also from top to bottom. Thus, the shape даса, 
look like this: 


will 


Shape a3, аб, a5, аб, a7, ав 
ъз, bé, b5, bó, b7, b8 
єз, сё, c5, 48, c7, св 
43, dé, 45, 96, 47, 48 
Let's adopt Principle that when we draw a shape, ve will 


draw the whole shape into its screen memory location first, then we 
change the attribute file. 


We will therefore store the attribute data that relates to that 
shape after its screen memory dai 


Unlike the shape, for each character there ís only one 
corresponding attribute data byte. 


LI 


Бо, to cater for the attributes data ме have four attribute data 
bytes after the above thirty two shape data bytes. (for a four 
character shape). 

**** Input of object shape ee 


label lines  from(H) to(H) from(D) to(D) 


FRGSHP 120 


27055 27190 


LBIKE 340 271% 27254 
LBATT 430 27255 27262 
RBIKE 260 27263 27326 
ВВАТТ 560 27327 2734 
кола 600 27333 27430 
(сат, 730 жаз 27442 
RAR 000 27443. 27538 
RCATT 900 27539 27550 
LTRUCK 940 27551 27766 
АТ 1230 27767 27793 
TRUCK 1280 27794 09 
RTATT 1379 28010 28036 
BLANK 1620 28037 28040 


Module from 27055 to 28040, 986 bytes, checksum is 79197. 


Suggested name "shapdb",( shape database ). 


А11 the above objects except the Frog can be grouped into SHAPE 
data bytes followed by attribute data bytes. 


The reason why the Frog shape database is not of that format is 
because ме have decided that the frog has only ome colour at amy 
опе time, either GREEN when it is alive, or RED when it is dying 
or YELLOW when it reaches hone. 


In this game, we use BLACK (0) as the paper colour except for the 
highway boundary and the top information line where ме use WHITE 
(7) ав paper colour. 


For objects that move only on the highway, paper attribute will be 
О and the ink colour will be that given in its databas 


Before we input the shape data base into memory and store it onto 
cassette, it is assumed that you understand charact 
representation in memory. 


We will now explain the assembler listing using the example of 
shape FROCl, starting at line 160. 


Im Line 160, you will see 


6987 er 160 FROG! DB 111,15,31,159,220,216,120,48 
OF 1F 9F DC 08 78 30 
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6987 18 the memory address in hexadecimal format 


oF is the start of the eight bytes of the current DB 
instruction in Hexadecimal value. 
The hexadecimal value of the next seven bytes 
im the next line between line 160 and line 170. 
Че orn. ird. 9FH, DCH, 08Н, 78Н, ЗОН. 


160 15 the line number of the assembler listing. 
FROG] is the label. This is for our benefit only. 


ов is a mnemonic. It means that what follows is a 
тсе of bytes, (Similar to DATA in BASIC). 


111,15,31,159,220,216,120,48 
are the bytes to be loaded into the memory. 


Now let's build the FROG! shay 


оо 00000000 00000000 
ot 00000001 10000000 
23 00100011 11000100 
25 00100101 10100100 
„„ — 01101111 11110010 
Ar — 01001111 11110010 
oF 1101 11111011 
LI ийип amuni 
oF — ononn mnono Fé 
OF 00001111 11110000 — FO 
n 00011111 11111000 РВ 
or 10011111 11111001 F9. 
be 11011100 00111011 38 
ов 11011000 00011011 18 
78 — 01111000 00011110 1E 
30 о0110000 00001100 ос 


Remember: 
i. we draw the bottom row first from left to right. 

ii. Then we draw the next row up. 

iii.For each character, we draw the eight bytes from top to 
bottom. 

iv. Then at the very 1 


у we НЫ in the attributes. 


FRGSHP in line 120 defines one of four pointers pointing to the 
four shapes of the frog. In the program, we will therefore be able 
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to find the correct shape given the direction of the frog. 

DEFY is a mnemonic that means we want to define a 2-byte 
"mm". The least significant byte is first while the most 
significant byte is next. 


**** Input of shape database ^4 


Use the Hexload program to input lines 120 to 1590 in the assembler 
Listing. Enter only the hex bytes as shown in column 2. 


Remember to save and verify the code before you proceed to the next 
part of this stage! 


Фени Design of the objects database bes 

We have decided that there will be a regular flow of six vehicles 
in the two lane of the highway. 

These are randomly distributed between the two lanes. 


Object database will store infor 
the traffic: 


Lion about the current status of 


For example, for each object we need to know: 


Existence, Movement cycle count, Direction of movement, whether 
it's partly on the screen or not, Position pointer, 

Shape database pointer, Attribute database pointer, 

Number of Rows the shape occupies, 

Number of column the shape occupies. 


The dat 
game суісе. 


carries this information about each object in each 


The first six group of databases from program line 1710 to 2040 
represent the six vehicles that ate going to be on the highway. 
When any vehicle moves off the highway, another vehicle will be 
generated randomly. 


One simple way is to prepare the initial information for each 
possible vehicle and store this in memory. 
When а new vehicle is generated, we Just go to the corresponding 
memory locations and restore the dai 


We will apply the same principle to the Police car and the Frog. 
Therefore, when we build up the object database, ме need not build 


up the temporary database, as this will be initialised by the 
progr: 
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* temporary database memory map 


Format: for the six existing vehicles, the frog and the police car: 
Existence DEFB 1 byte 
Cycle count — DEFB — ! byte 
Direction DEFB 1 byte 
Realabstract DEFB 1 byte 
Position DEFW 2 bytes 
Shape pointer DEFW — 2 bytes 
Attribute ПЕРИ 2 bytes 
Row DEFB 1 byte 
Colunn DEFB 1 byte 


TOTAL 12 bytes 
label lime from(H) to(H) — from(D) ro(D) 


OMIEXT 1710 6:25 6ЕЗОН 28197 28208 
OBZEXT 1800 ЕЗІН erben 28109 28220 
ОВЗЕЖТ 1850 _ 6E3DH eee 28221 28232 
OB4EXT 1900 ee GESAM 28233 28204 
OBSEXT 1950 вЕ55Н бЕБОН 28245 28256 
овехт 2000 ӨЕБІН 6E6CH 28257 28268 
PCAREXT 2070 бЕБОН БЕТЕН 28269 28280 
FRGEXT 2180 белән  6EBON 28281 28288 


Аз mentioned above, these are only temporary working stor: 
information that they contain changes as the game proceed; 


There are two other major temporary working storage area 
They are used to store what is underneath the frog and the police 
саг respectively. 


label Line# from(H) to(H) — from(D) коб) 


FRGSTR 1650  6DB9N  6DACH 28041 28076 
PCSTR 1660  6DADH 6ЕФНО 28077 28196 


Ме do not need to define any of these locations - only allow for 
them. We only пева to build up the following database. 


The object database is organised in the following ма; 
FRGDI frog database 
DBINDEX other object datab: 
right bycycle баса 
left bycycle database 
right car database 
left car database 
right truck database 
улов left truck database 


асов left police car database 


LPCATT left police attribute database 
RPCDB right police car database 
ЕРСАТТ right police car database 


label пей  from(H) to(H) Егото) to(D) 


асов 2260  6EBIM 6Е8ВН 28289 28296 
DBINDEX 2320  6E89M 6EM 28297 28308 
RBDB 2000 66934  6EAON 28309 28320 
LBD 2470 белін  6EACH 28321 28332 
RCOB 2540  6EADH беввн 28333 28344 
LCDB 2610 6EB9H бесан 28345 28356 
RTDB 2680  6ECSH  6tDOM 28397 28368 
LTDB 2750 берін берсн 28369 28380 
LPCDB 2820 крон eren 28381 28392 
LPCATT 2890 ввЕ9Н ЕРЕН 28393 28404 
RPCDB 2930 6EFSN ern 28405 28416 
RPCATT 3000 6FOIM 6FOCH 28417 28428 


Module from 28289 to 28428, 140 bytes, checksum 7697. 


Sugg name is "objdb". (object database). 


We know that all objects except the FROG have a twelve bytes 
database. 


The meaning and contents of each byte is: 


+ Existence ( 1 byte ) 
t to zero when the object is nonexistant. 
= set to value n where (n ~ 1) ік the number of cycles 
that the object will wait before it is allowed to move. 


n value left and right cycle is 2 
left and right car is 3 
left and right truck is 6 
police car 2 
frog is в 


in other words, the police car moves every cycle, 
the motorcycle move every alternate cycle etc. 


* Cycle count ( 1 byte ) 
= initially set as 1 so that it is ready to move straight 
avay and decrement by one every cycle. 
- when it reaches zero, the object will be allowed to 
move and the count will be reinitialised 
to the value held in the existence byte. 


+ Direction (1 byte ) 


= all left to right traffic (le. top lane traffic) will 
have direction value zero. 


= all right to left traffic (ie. bottom lane traffic) 
will have direction value one. 


+ Abstract/Real flag ( 1 byte ) 

= this defines whether objects is partly off the screen 

= all left to right traffic will start off with value 
zero (abstract). 

= left to right traffic will change this to one when 
their position points to the real screen 48208. 

= all right to left traffic will have flag start off vith 
value ome (real); the object has a position pointing to 
the screen. ie ВОЕН. 

- as the right to left traffic moves off the screen, 
leben the position pointer moves from 48СОН to 48BFH, 
this will be changed from real to abstract. 


* Position pointer ( 2 bytes ) 
— 2 bytes pointer storing the current position of the 
object. 


* Shape pointer ( 2 bytes ) 
= 2 bytes pointer pointing to the shape databj 
object. 


of the 


+ Attribute pointer ( 2 bytes ) 
= 2 bytes pointer pointing to the attribute Фата! 
the object. 


је of 


* Row (1 byte ) 
= store how many rows the object shape occupies. 


+ Column ( 1 byte ) 
= store how many columns the object shape cake 
= this value includes two columns of blanks, one at each 
end of the object. 
The purpose of these two extra columns of blanks is to 
avoid the traffic getting too close to each other. 


Now you can key im the object inittalise datat 
to 3010. 


e from listing 2270 


You can use EZ-code or Mexload to enter this module. 
If you use EZ-code, remember to save the source listing 
the dumped listing. 


=== General database жө» 


We have covered so far the database from 69AFH to 6FOCH 
( 27055 to 28428 ). 


Now we are going to build up the rest of the database and we 


то 


classify this as "general database". 


This is organised as below: 
line | 500 to 630 SOUND 
660 to 690 SCORE MESSAGE 
720 to 1210 GENERAL 


label line  from(H) to(H) from(D) to(D) checksum 


PCTONL 500 6FODR 6F10H 282 
кто? 510 6FIIM PAN 166 
номтон 540 6FlSH eren 2565 
SCRMS! 660 6РЗОН eren 540 
SCORE 670 бғазн eren 288 
SCRMS2 680 eren бЕУЗН nm 
NISCR 690 ers er sen мо 


Module from 28429 to 28506, 76 bytes, checksum 4813. 


Suggested name " 


(general 


е). 
You only need to input from line 500 to line 690, 


From Line 720 to line 1210, memory 6F59N to 6FB2H 
( 28505 to 28546 ), these are all variables used by the progra 


Line 1100 to 1150 are instructions with mnemonic ЕШ. This 
а value to the corresponding label and is used by the as 
program. You do not have to enter anything 


Conclusion 


Now we have covered che vhole database ai 
O9AFH TO 6824 ( 27053 to 28546 ). 


trom menory 


Examine all modules that you have built, their names, their memory 
range before you proceed the next stage of the building up of the 
FREEWAY FROG program. 


You should have mow developed three modules: 


name frommen tomem length checksum 
abpdb 27055 28040 

сымы 28289 28428 

zend 28429 28504 76 


Note that the database occupies nearly 1400 bytes!! 


m 


Stage 2-Initialisation 


жені Screen Setup e. 


In this module, we set up the highway, the score display, the frog 
аз well as initialise all control variable: 


We will do it in three parts. 
First, clear the screen and put in the highway. 
Secondly, put in all the frog 

Thirdly, display the score. 


This module includes the following routine 


routine from(H) to(N) — from(D) te(D) 
mur ВЗН. 700АН 28547 28682 
CLRSCR трн 73164 29399 29462 
КО 7004 7040H 28736 
носну тозан 70дон 28736 
ШЕ тоын тон 28756 
LINEUP 70594 70798 28793 
DISASC 73284 73491 29513 
SCRIMG ern 7786 505 
FINAL 77FeM 78101 30749 2466 


Module spread from 28547 to 30749, 2201 bytes. 
Suggested name "init", Cintlalisation). 


Enter first CLRSCR, DRMMWY, Piller, FINAL into their corresponding 
memory locations. 


Then enter INIT routine. Enter three bytes of zero for the 
following lines instead of the CALLs because the routine which are 
called haven't been developed ye! 


line#  address(H) address(D) 


1430 БРАРН 


1470 6ғын 
1490 rcon 
1530 — 6FCBH 
1570 erden 
1590 erben 


1630 бРЕТН 
Then enter the following codes into memory starting from 32000. 


Save the module from 28547 to 10598, 2052 bytes before running the 
code in memory 32000. 
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n pr sDisable interrupt 


09 EX reserve HL! 
#5 PUSH нъ 

09 кк. 

соза СА. INIT 

ЗЕРЕ KEY Ш Ат STRAP SPACE KEY 
DBFE IN А, (РЕН) 

E601 эю 1 

20F8 ж NZKEY sloop if mot press 
CDPE?? — CALL — FINAL ifinalisation 

09 кх irestore HL" 

t тр HL 

[2 EXX 

тв Li зеваые interrupt 
© RET 


You should see the screen blacken and four white Lines: 


The following is a brief description of what each routine does. 


E 
set border colour to black 
initialise frog-crash flag, frog existence, ganetlag 
mumber of frog 
t rahdos ROM pointer 
t frog station (also initial position of frog) to 
SOACH 
call clear-screen 
call draw highway 
call line-up fri 
load score message 
print score 
load high score message 
print high score 
initi all objects as nonexistent 
initialise chase flag, siren sound flag and score 


(five of them) 


79 
Till top highway Line (32 characters of 40AOH) 
fill middle highway line (32 characters of 4860H) 
fill bottom highway line (32 characters of 50208) 
‘remember that highway їз white paper black ink 
Wnfill top two-character bytes of top highway 
(therefore, they are white) 
unfill bottom two-character bytes of bottom highway 
(they are also white пом) 
of the middle highway 


redraw middle two-byt: 
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Т 
initialise fill character (ОРЕН) 
set loop count to 32 (one line 32 characters) 
draw one character (8 bytes) 
move pointer to next character each time 


FINAL 
set vhite border 
blank screen 
set screen attribute file to white paper and black ink 


1f everything is fine, save the module first from mesory 
location 28500 to 30800, 2300 bytes. 


Now enter LINEUP, DRWFRG routines. Check the checksum and save the 
whole module again under the same name, same addresses. 

Then change memory from БРАРН (28591) to 6FBIM (28593) to that it 
corresponds to line 1430 of the assembly listing. 

fe. CD 55 70. 


Hun 32000 and you will see five frogs line up at the left bottom of 
the screen. 


The following are descriptions of what these two routines do: 


извор. 
set frog direction to 1 (facing right) 
to PROC 
number to 2 (green) 


return 


for number of frog 
push BC, DE, HL onto stack 
draw the frog by calling DRWFRG routine 
pop HL, DE, BC from stack 
update draw position 


DRVFRG 
draw shape using convention discussed earlie 
calculate attribute pointer 
fill attribute of frog 


LI 


il 


* * * 


Stage 3-Regular Traffic. 


Im this stage, we develop the regular flow of traffic. 
ie. all traffic except police car: 


Traffic control ( including regeneration of traffic) 
regenerate traffic 
Moving traffic 
moving control 
faving traffic 
determine drawn shape 


Below is a table of all routines in this module. 


name — Line# from(H) tech — from(D) to(D) 


TFCTRL 3090 тоюн  70D8H 28861 
REGEN 3320 70094 7108н 28889 
MOVTRF 3700 7IOFH 71АЕН 28943 
MVCTRL 4720 7ЛАРН 72084 29103 
DRAW 5560 7209н 72994 29193 
RSHAPE 6630 7а96и 7206н 29334 
RANDNO 15050  77CCH 7700н 20668 


Module from 28861 to 30685, 1824 bytes. 


Suggested nane "regtrf". ( regular traffic). 


it is useless to generate а total checksum of the whole 
use the memory range covers some undeveloped memory 
area. But it is important that you check the checksum of each 
routine after entering it. 


We develop this module in two parts. 


Firstly, the draw routine for traffic. 
Secondly, the traffic control and draw control. 


Input DRAW, RSHAPE routines into their memory region, checksum and 
save thes. 


тв 


Then entering the following testing program starting from memory 
32000. 


в 51 
09 Exx 

#5 PUSH нъ 

09 Exx 

CD836F CALL тат 

Leos @ МЗ атом count 

32606F ш (кон), А tore in ROW 
309. ш A, 9 icolumm count 
325F6F ш (COLUMN), А istore in COLUMN 
11926¢ ш DE, RTRUCK right truck shape 
төле ш HL, RTATT — iríght truck attri 
22646 ш (ATTPTR), MListore in ATTPTR 
эко! ша ес to real pos 
212248 шш ні, авон 

00972 CALL DRAW 

ЗЕР KEY шо мт ikey trap 

ща IN ASCOFEM) 

E601 до 1 

208 E ма, KEY 

КШ CALL FINAL 

09 СЯ 

21 ЮР HL 

09 ЕЯ 

т 21 

с RET 


modules in the order they a 
Load the init module. 

Load the routines you developed in this stage. 
Save memory 27000, 4000 bytes into "frog" module. This will 
includes all routines you have developed so far. 

Enter and save the above teat routine in memory 32000. 


created. 


Run 32000 and you should see the screen set up and a right truck on 
the top lane as vell. 


You сап change the parameters in the program above between CALL 
INIT and CALL DRAW to test all other object shapes. 


Below is a brief description of the two routines. 


DRAW 
Similar logic to DRWFRG 


RSHAPE 
trap lower 5 bits of low order byte of position 
paraneter 
subtract from 1FH and add | 


m 


trap lower 5 bits again 
determine SKIP and FILL depending on real or abstract 
calculate attribute position and store in ATTPOS 


Enter TFCTRL, REGEN and MVCTRL routines in their memory region and 
save the whole module. 


Edit the testing routine as follows: 


or 

Exx 

pusu HL 

L3 

сли. — INT 
срврто MOVE САШ. kern. 
СПОРІ CALL — MOVTRF 
ЗЕТЕ ш А, TPH 
[3 IN A, (OFEN) 
кво дю 1 
2072. ж на, MOVE 

CALL — FINAL 

хх 

юр u. 

кк 

Er 

RET 


By now you should realise that we save the whole stage module while 
we are developing that stage. 

Once a module is fully developed and tested, it will be merged 
together with previous modules and saved into the "frog" module. 


We test the modules by a small testing program starting from memory 
32000. 


After you have done all the housekeeping work for your modules, 
test run the new "frog" module, 


1f everything is correct, you should see the whole screen as before 
plus all traffic moving at a very fast speed in the two lanes. This 
is because there is no delay between each program cycle. 


А short description of the routine: 


теста. 
load generation flag 
if mot regeneration 
decrement flag count 
else 
regenerate the first nonexistence object by calling 
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the REGEN routine 
return 


REGEN 

save existence database pointer 

generate random number 0 to 5 

test the first two character of the screen position 
where the object 15 created 

Af the sum of the attributes of those two position is 
mot equal to zero 

then return (traffic jam) 


else 
determine the initialise database 
load into temporary working databa 
set regeneration cycle count to 2 
return 


eurer 
for all existing objects 
decrement cycle count 
if count reaches zero 
reload count from existence 
move one character left or right 
store mew position in NEWPOS 
test attribute correspondence of the front of 
objects 
if any nonzero ink 
LE mot green 
set jam flag 
else 
set crash flag 
Af jam flag set 
load cycle count with 2(move one cycle 
later) 


return 
else 

store new position 

call MVCTRL (nove control) 


уста 
A edge reached 
change real/abstract flag 
if left moving 
if on edge (position low order byte = 1РН) 
if abstract flag 
set mon exist, return 
else 
goto Li 


else 


1% 


inter in АТТРТЕ 

LUMN of shapi 
м om pointer pointing to in ROM 
score ә HIGH score e 


Score 9 HIGH SCORE 0 
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‘Stage4-Police Саг 


Та this stage, ме will introduce the POLICE car into the program. 


The POLICE car will be generated randomly and enter with SIREN 
sounding. It moves every cycle and there is no traffic jam in its 
course. lt will overtake any regular traffic before it. 


That is why the program needs to save what is underneath the police 
car and put it back when the police car moves on. 


Below are all routines in this module. 


name lines  from(H) to(N) from(D) to(D) checksum 


RESPC 9560 Тао 74Сін 29776 29889 11011 
POLICE 7930 734AN  73DEM 29514 29662 15769 
STRPC 8830 73DFH тмн 29663 29775 10615 


There are routines which are called in this module which has been 
developed in previous modules. 

Module from 29514 to 29889, 376 Бук 

Suggested name "police", 

Enter POLICE and ТАРС routines. Checksum and save them in the 


"police" module. 


Then edit the testing program to the following: 


тин н 


CALL — INIT 
MOVE CALL — TFCTRL 
CALL — MOVIRF 

CDAA73 MOVE! CALL POLICE 


ш АТН 
INA, (OFEH) 
дю 1 

E JR NZ, MOVEL 
CALL PINAL 
EXK 
[E 
555 
в" 
RET 


Load the "frog" module, then the "police" module. 


Hun the testing program. You should see the POLICE car moving very 
fast оп the highway. 


ТЕ you want to put in other traffic as well, change the relative 
ішер to ЈЕ NZ, MOVE. 
Remember to recalculate the displacement offset. (EFH). 


As it moves, you would see the POLICE car wipe off the traffic 
shape as it overtakes them. It may be so fast that you wouldn't 
notice. 

But you can tell when some traffic starts to run into the vehicle 
im front of them. 


Let's look at these routines: 


POLICE 
1f police car non-exist 
get а random number 
1f not a mutiple of 31 
return 
else 
set chase flag 
determine top or bottom lane randomly 
load corresponding initial datal 
е direction 
store position pointer 
retrieve position 
move and store NEWPOS 
set ROV, COLUMN, REAL/ABSTRACT flag, POS before 
call RSHAPE 
get resulted ATTPOS and test head of shape for green 
ЗЕ green attribute 
set crash flag 
blank front of police car 
call STRPC (for storing of what's underneath policecar) 
update position database 
call MVCTRL (for moving on and off the screen) 
turn off chase flag if non-exist 


STRPC 

set HL points to NEWPOS 

set DE points to PCSTR (police car store) 

Store position and 5 byte of information starting from 
ROW variable 

store according to SKIP/FILL format 
all screen memory first 
then attribute file 


LI 


Enter the RESPC routine and merge with the previous two routines. 
Save the whole module as "police". 


You need to edit the testing program again to test the storis 
restoring. 


and 


Although we included the STRPC routine we are not sure that it 
saved the correct data underneath the police car. Only the RESPC 
can help us to know that, because it puts what was stored back onto 
the screen. 


change the tesing program to the following: 


MOVE — CALL — TFCTRL 

ce CALL — RESPC 
CALL моутке 
CALL — POLICE 


Ш дат 
їн A, (OFEN) 
мою 1 

тос JR u, MOVE 


Adjust the relative Jump before you test run the module with 
"frog" 


You should see the POLICE car overtaking vehicles without wiping 
them off, 


The RESPC's logic is as below: 


RESPC 
return if police car nonexist 
restore the position and 5 bytes into variables 
starting from ROW 
restore screen memory then attribute according to 
SKIP/FILL format 
return 


Finally, enter SIREN routine, checksum and merge it with the rest 
of the "police" module. 


Load "frog" module then reload the new "police" module. 


Edit the testing program in memory 3200018. 


following: 


0877 


ng prog 
This 
tput 


а 
во to DELAY 
1f no police 
311 038 
Score 


INIT 
TFCTRL 
RESPC 

моутағ 
POLICE 


SIREN 


AH 
A, (OFEN) 


1 


NZ,MOVE 


11 find the whole 
a constant dela 


or а downcount delay loop 
pressed 
о DE, NL 
th "frog" in the memory and re 
© нген score . 


' 
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Stage5-The Frog 


In this stage we develop the frog routines. 
We need to regenerate the frog when a frog dies. 


We also need to handle the frog movement, save what is underneath 
{t and restore what was stored back when the frog moves. 


We also need со handle the frog crashing or home run and calculate 


We build up this module in thr 
Regenerate and move frog 
store what is underneath 
handle crashing, homerun and score 


parts as below. 


ALL routines within this module is as follows: 


баве _ linef  from(M) tec — from(D) to(D) checksum 


FROG 10280 74С2н  74E2N 29890 29922 — 3818 
ВЕСРАС 10520  74E34 о 750FM 29923 29967 4079 
MOVPRG 10770 75108 75094 29968 30165 19943 
RESFRG 11870 7506н  7627H 30166 30247 8492 
STRPRG 12440 76284 7690H 30208 30352 10136 
CRASH 13160 7691M — 76A6H 30353 30374 2767 
FRGDIE 13280  76A7H  7707H 30375 30471 9965 
FRGTON 13890 77084  771CH 30472 30492 2435 
CALSCR 14040 77104  776EH 30493 30574 — 8106 


Module from 29890 to 30574, 685 bytes, 
Suggested name "frgrtn" (frog routine). 


Enter FROG, REGFRG, MOVFRG, RESFRG, STRERG and CRASH routines. 


Edit the testing program as following: 


CALL — INIT 
MOVE САШ. TFCTRL 
CALL — RESPC 


ш irn 


IN ASCOFEH) 
дю 1 
aR N, ou. 


Since we haven't entered the FRGDIE routine yet, replace the coding 
in line 13190 of the assembly listing by 
99, 00, 00 


Run the testing progr 


imd you should be able to move the frog. 
The controls are top, 


denn, "i"-left, "p"-right. 


When the frog crashed, it will simply disappear because the FRGDIE 
routine which handles the dying procedure of the frog hasn't been 
put in yet. 


The description of these few routines are as following: 


FROG 
the control routine for the whole FROG module. 


1f frog crashed 
goto CRH 


t score-flag to no score (0) 
сап REGFRG 
decrement cycle count 
if count non zero 
return 
else 
reset cycle count 
call MOVERG 
Af not crash 
return 
CRH:call CRASH routine 
return 


REGFRG 
if frog does mot exist 
load frog initial database to working database 
update frog station to three position left 
imitialfse OLDFRG and NEWFRG to FRGPOS 
initialise frog storage area to O 


movere 
inittalise registers 
C — absolute movement 
B - frog direction 
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DE- frog shape 
test frog movement 
1- up, а - down, i - left, p - right 
store shape, direction 
if absolute move is zero 
return 
else 
restore old frog position 
calculate new frog position and store 
test up screen position, right screen, bottom screen, 
frog station 
if valid 
store position into NEWFRG 
set score flag. 
restore OLDFRG 
if OLDFRG equal МЕМЕВС 
return 


call RESPRC 

set OLDFRG equal NEWFRG 

move stored direction, shape pointer to frog 
database 

call STRERG 

return 


RESFRG 
restore underneath frog based on OLDFRG position 
memory first then attributes 


STRFRG 
store underneath frog based on NENFRG position 
draw frog while drawing 


CRASH 
reset crash flag 
set frog nonexist 
call FRGDIE routine (dying procedures) 
call RESFRG routine (place back what was underneath) 
decrement number of Frog 


After you have saved up all the modules, enter the CALSCR, FRCDIE 
and РАСТОМ routine. 


To кезі the crash handling routine, replace 13190 of the listing by 
the following instruction: 


7698 СрА726 CALL — FRGDIE (30360) 
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Edit the testing program to the following: 


Merge the routine in the "frgrtn" module and run memory 32000 
together with the "frog" module. 


When the frog cri 


hes, it will flash red and vanish. 


FRGDIE 
test frog reaches home or die 
t die tone, red colour attribute 
reaches home 
add one to third digit of score 
(bonus 100 points) 
call DISSCR (display score) 
set home tone, yellow colour attribute 
draw frog based on OLDPRG, FROGSM, and attribute just 
set by call DRWFRG 
ih frog with the attribute five times 


FRGTON 
call TONEL (tone code from SIREN routine) 
move up or down the tone database depends upon attibute 
used to flash the frog ( (Е yellow then down db ) 
(Cif red then up db) 


CALSCR 

1f frog non-exist 
return 

en 


4f score flag not set 
return 
else 
if go up 
add one to tenth digit of score 
(10 points) 
else 
1f mot within the highway 
return 
else 
add one to tenth digit 


Stage6- Control 


In this stage we develop the control routine for the whole program. 


The main control is that when the game is finished, high score is 
updated and the game is restarted automically. 


In amy cycle, the user can abort the game by pressing the space 
кеу. 


You will find that line 180 to 440 of the listing looks very 
similar to the testing program ме have been developing. 


Routines left for program are as follows: 


name lines from(H) to(N)  from(D) to(D) checksum 
START 180 69784 69AEH 27000 27054 — 8427 
OVER 15200 770ЕН ТРОН 30686 30717 2491 
Now enter these routines into the memory. Save them together with 


the "frog" module and save the whole module as "frog". 


Run 27000 instead of 32000 and you will have the whole program 
working. 


over 
соераге 
for the 
ин 


1 digits of HISCR and SCORE«I 
rst nonequal digit 
CR digit de lower 
update MISCR to SCORE+1 
else 


Congratulations and I hope you enjoyed the development of the 
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DECIMAL HEXADECIMAL CONVERSION TABLES 


Appendix D 


We сап demonstrate using this table by working through ап example. 


Let's find the Hexadecimal equivalent of the decimal number 6200. 
We have to determine the 16-bit binary number; 
ie bbbbbbbb  bbbbbbbb 
нов тов 


i. From the leftmost column of the table under the heading xx00, 
we find that 6200 is between 4096 and 8192. So we choose the lower 
value 4096 and from the row value, we take the most significant 
four bits of the НОВ (High Order Byte) to be 1 te 01. 
cos  bbbbbbbb 
нов 10 
ii. The second step is to determine the less significant four bits 
of the NOB. We find the difference of 6200 and 4096 to be 2104. 
Since the differ ter than 255, we refer to the 
under the column heading O0xx 
amd find that 2104 is between 2048.and 2304. Again ме take the 
lower value 2048 and arrive from the row value that the less 
significant four bytes of НОВ is 8 ie 1000, 
00011000  bbbbbbbb 
нов [7 
lii.The third step is to determine the LOB (Low Order Byte) for the 
number. Ме find the difference between 2104 and 2048 as 56. From 
the Large middle big sub-table ме find that 56 15 at the 
intersection of row 3 and column 8. So ме take the LOB as Зан. 
00011000 00111000 
нов. ов 


So the MEX-value of the number 6200 is 18388. 
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APPENDIX G 
FLAG OPERATION SUMMARY TABLE 


INSTRUCTION с|2|ғМ5| м] н|соммемт 
‘ADC НЕ, SS „| „| у | =| of х вън ace with carry 
ADX s; ADD $ e| «| v | • | o| | Вън ава or aca with cary 
ADD 00,55 o| -| -| -| o| x| 16 ава 
AND s оер жо 1| Logica! operations 
ать, –|•| x| x] 9| 1] state of pit b of tocation s is 
copied into the 2 flag 
ccr æ | -| - | -| o | х|сотретем carry 
cpp; cron; cei;cein |- | e| #| x| 1 | Х | Воск search instruction 
Z^1 if A- (HL), else 2-0 
РУЛ if ВС#д, otherwise 
271 
ЕД e| e| v | «| 1 | | Compare accumulator 
ср. -| -| - | - | 1 | 1 | Complement accumulator 
DAA e| e| p | «| –| «| Decimal adjust accumulator 
пес» -|»|ч|4111| ө|вәкасетет. 
Ir, (C) -|4|ғ|%| e input register indirect 
INCs -| | у | • | 0| е 36 increment 
–|•| x | x| 1] x} Biock input 2-0 и B0 
else 2-1 
INDR:INIR, = | x | x| 1| х Block input z- 
else 2-т 
LDAJ;LDAR - | w|irr| e| a | 0| Content of interrupt enable 
Flip-Flop is copied into the. 
PIV flag 
сор; LOI -| x| æ | x | 9| ој Block transfer instructions 
LOR: ция SEE ir acro, otherwise 
NEG «| e| у | • | 1| e| negate accumuiator 
ORs o #| 0| | Logical OR sccomulator 
OTOR: OTIR =| 1| x| x] + | Х Block output: 2-0 И 870 
‘otherwise 21 
ойто; OUT! –|•| x] x| 1| х Block output; 2-0 it 890 
otherwise 2 
RLA;RLCA;RRA;RRCA| ө | -| — | -| o | © | Rotate accumulator 
RLD; RRD =| •| > | # | 0| | | Rotate digit lett ond right 
ers ales ag: RRCs | e| | P | # | o| Q|Rotateand shift location s 
SLAs; SRAs: SALS 
зас HL, ss „| o| v | e| 1 | x| 16bit subtract with carry 
scr 1] -| - | -| о | озату 
ssc sus, v 1| | вы subtract with carry 
XOR x 9 P 0 0) екеніме OR accumulator 


Appendix С 
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OPERATION 
Carry flag. C-l if the operation produced a 
carry from the most significant bit of the operand 
or result. 
Zero flag. 2-1 if the result of the operation is 
Sign flag. 8-1 if the most significant bit of the 
result is one, ie а negative number. 
Parity or overflow flag. Parity (P) and overflow 
(0) share the same Flag. Logical operations affect 
this flag with the parity of the result while 
arithmetic operations affect this flag with the 
overflow of the result. 
ТЕ P/V holds parity, P/V«l if the result of the 
operation is even, P/V-O if result is odd. 
ТЕ P/V holds overflow, F/V=1 if the result of the 
operation produced an overflow. 

f-carry flag. Hel if the add or subtract 
operation produced a carry into or borrow from bit 
4 of the accumulator. 
Add/Subtract flag. Nol if the previous operations 
vas а subtract. 


Н and N flags are used in conjunction with the 
decimal adjust instruction (DAA) to properly 
correct the result into packed BCD format following 
addition or subtractionusing operands with packed 
BCD format. 

The flag is affected according to the result of the 
operation. 

The flag is unchanged by the operation. 

The flag is reset (-0) by the operation. 

The f et (a1) by the operation. 

The flag result is unknown. 

The P/V flag is affected according to the overflow 
result of the operation. 

P/V flag is affected according to the parity result 
of the operation. 

Any one of the CPU registers A,B,C,D, E. u, l. 

Any B-bit location for all the addressing modes 
allowed for the particular instructions. 

Any 16-bit location for all the addressing modes 
allowed for that instruction. 

Refresh register 

B-bit value in range 0-255. 

16-bit value in range 0-65535. 
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MNEMONIC 
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 АРРЕНОХ 
280-CPU INSTRUCTIONS SORTEO BY MNEMONIC 


MNEMONIC | HEXADECIMAL 


нЕхлрєстмл | ммемомс | нехдоесмас 


[TE 
АБСА На Бове xx 
ADEA sga) PD BE e 


Е 
5 
Ee | Шы 
Е ва 
Е B 
Em 
ЕЯ 
ва 
prm 
Bm 
8 
г 
5 
Sax 
E 
E 
H 
3 
3 
5 8 
EH 8 
Бах 
А сввс. Ета E 
Eid SS IW R 
Et ЧИЩЕ Em 
КЫ БЕТТЕН ЕН 
за Белш, БЕ 
mau 85 zm ва 
3 82 is Bg 
8 82 [mS fa 
E ва „ ва 
8 gu „ 88 
So 8: mS БШ 
5 gr [ats BS 
8 Ва Eu. Б 
Ss „ 3% EN) Sum 
ва На аи | P 
кешин 88 Е 
82 5 33 | 8 
EH : я |. 8 
82 A 35 8 
ER лы 55. |ШЕ 5 
сва ADOR — COXXXX а E 
S2 Eu SEE (ms ОШ 
БЕП |Ша 08 
БЕН [ES Ба 
BER [mee Ба 
све CALLPEADOR ЕСХЖ ХХ m" | 
3 | иб ешп |а Er 
ЕРУ E Em т жол? 
ЕЗ Ни a” 
Epa СР ха DO BE xx 2 
ЕЗ СР унів) РОВЕХХ ве 
ETA РА ве си 
50 Св xx 56 | сев ва о 
FDCBXX56 | ос в MEX 
— 25 2 nm 


моласы: У 
gw [um рю 
Баз |e БЕ 
soe |. а 
z 
Бах 
Е 
Н 
1 at E 
1 8 Е 
ШАЉЕ E EM 
SESS В 85 
Bees В En 
BRA З ES. 
BE R 58 
БЫР R I: 
SE E Sa, 
ШЕ Rao Е 2 Er: 
Bm: R БЭ 
ЧЕД, Биш | 
паша Bam 8 
8 — БІЗ 2 
WE: БЫ, Ён 
БЫ, БЕЙ 
Biss БЕН 
SEE: BRE [Ub E 
Биш: ЖЕ [BEI Ба, |Б 
DC HEC METTE C |Р 
9 75 ithe, 
S Sr 
Би ЕЕЕ 
КЕШЕ Е 
На E 
БЕ Е 
non ET 
Eis Sak 
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82802002002280202000028002000000280252 во: 


28883788253 


— — 
En Nue. ae 
БЕН Ew BE 
E Бива Zinn 
ІН Ба Rass 
E Би“ ss 
ВВ „ He gg 
2882 Ai Be ga 
3 Bis пещи ни ЫШ 
ЕРЕН ers B „ = 
38 | E 
38 [m Bane 
38 [mi Ed 
38 [m EH 
88 ЕН 
КЕЛЕ ЕН 
Е ЕЗИ EE 
33 ЕН a2 
ЕРЕ Ба 55 
Sao [RN 82 
84 [E ЕРИМ 
55 |: Дана 
ЕЕ Е 
ЕСЕ ae 
МЕ aes ЕЗ 8B 
Бани |Е: 58 
33 |5 ЕН 
35 8 Е 
33 |ie Er 
Su ЕН Bien 
88 |: Baus 
ae [md Е 
33 RR ЕН 
ДЕ „|ШЁ ЕН 
San 58 
Бани Ба йн 
SEUT Eee. ЕН 
ВЕ а Ed 
ae | REL! EE 
SE [ES Sinn 
Su |: бази 
ВЕ [ES E 
88 |S ЕН 
ЕЕ BR 
s 189 85 
х [ER ЕН 
з [ER Sa 
2 | ж ЕН 
Б (ЕШ ai 
5 ENS Be за Bebe 
Н i р Шш numm 
8. ЈЕ НЗ ая 
бе 1 | 
БЕ (ЕНШ Е 
oe Ыы an 
San gi 
Sanc ER 38 
ЕЕ 85 
ЕГУ” ES 55 
33 45 Bo ax 
33 |e Beaux 
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gi |EnNa ЕН 
55 ШЫ ЕН 
Ми, пещи S. ЕН 
Ма Бени БИ ЕН 
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—.— 2 |B SE 


E 


Mnemonic  нехасестлі | ммемомс _ нехаоесма | mnemonic | некдоесмас 
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fc sos F 
. — 5 
ке xs 
pet ag 
E пара 
E 
5 ЕН 
Ж ORE 
pru. 5 
um à 
ООШ TUE 
um | 
3 
шимен e 
| 
bec ЕЕЕ 
Binary coded decmai 62.63. 126. 
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Е dente gag 
= eC 
EE 
E 14 
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шт i 
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БЫ шш 
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meee 
s 
158 
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rer 
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[3 25 
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Processor ЕЈ 
атағы 3» 360.101 127 
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ст 
SERE 
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fen 
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Зове 
ава 
быта пад еме) 
Supracton ta v 
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SPECTRUM 
MACHINE LANGUAGE FOR THE 
ABSOLUTE BEGINNER 


{411 oot this page and return it promptly in order 
that ve may keep you informed of пем software and special 
offers that arise. Simply cut along the dotted line and 
return (t to the correct address selected from those 
overleaf. 


Where did you Ieas 


ot this produce? 
ГО magazine, 11 
C Through a ны 


О sov и in a perati Store 


„ which опеана 


C име: Please. оенэ. 


Which Magazines do you purchase? 


кешігуі. 


осам 


It 


What Age are you? 


СЗ tots Que 20-2 Dover 5 


Че are continually writing new material and vould a 
receiving your comments on our product. 


Ном would you rate this book? 


О вне Ома tor money 
О ом Певгв ние 
О roor O overpriced 


Please rell us what software you vould like to see produced 
for your computer: 


Name sss 


Address. 
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Your best course is to work through a book such as William Tang's 
Spectrum Machine Language For The Absolute Beginner. 

This book is one of the best һауе seen on the subject — for once 
the title is right on the nose! | can recommend this to anyone just 
getting interested.’ — Popular Computing Weekly. 

Ifyou are are frustrated by the limitations of BASIC and want to 
write faster, more powerful, space-saving programs or 
subroutines, then Spectrum Machine Language 

For The Absolute Beginner is the book for you. 

Even with no previous experience of computer languages, you will 
be able to discover the ease and power of the Spectrum's own 
language. Each chapter includes specific examples of machine 
language applications which can be demonstrated and used on 
your Spectrum, as well as a self-test questionnaire. 

At the end of the book, allthis is brought together into an entire 
machine language program — from design right through to the 
complete listing of an exciting, original arcade game. 


ISBN O-&b1b1-110-1 


Melbourne 
те. ИМ 


